`sys._clear_internal_caches()` no longer clears the type cache

Documentation

Doc/library/sys.rst says sys._clear_type_cache() clears the internal type cache, and that sys._clear_internal_caches() clears all internal performance-related caches. Neither does any more. Both reach it only through PyType_ClearCache(), which is now just return NEXT_VERSION_TAG(interp) - 1;.

import sys, _testinternalcapi

class C:
    x = 'v'

C.x                                        # populate the per-type lookup cache
print("cached:                          ", _testinternalcapi.type_cache_lookup(C, 'x'))
sys._clear_type_cache()
print("after sys._clear_type_cache:     ", _testinternalcapi.type_cache_lookup(C, 'x'))
sys._clear_internal_caches()
print("after sys._clear_internal_caches:", _testinternalcapi.type_cache_lookup(C, 'x'))

cached:                           (1, 'v', 131161)
after sys._clear_type_cache:      (1, 'v', 131161)
after sys._clear_internal_caches: (1, 'v', 131161)

The C API side is already documented. Doc/c-api/type.rst says the function is now a no-op, and GH-150160 added a matching porting note. The Python wrappers look like the spot that was missed.

Linked PRs

• gh-155378
• gh-155391

Comece pelos wrappers Python para sys._clear_type_cache() e sys._clear_internal_caches() e, em seguida, compare o comportamento deles com Doc/library/sys.rst e a descrição de no-op em Doc/c-api/type.rst. Verifique os testes existentes relacionados a essas funções e a nota de portabilidade de GH-150160; considera-se concluído quando os wrappers, a documentação e os testes refletirem consistentemente o comportamento atual.