Raise `DeprecationWarning` for `sys._clear_type_cache`

[tomasr8]

Feature or enhancement

Proposal:

sys._clear_type_cache was deprecated in 3.13 in favour of sys._clear_internal_caches, however there is no runtime DeprecationWarning raised. Should we add one? AFAICT, it is not soft-deprecated, so the intent is to eventually remove it.

cc @brandtbucher since you deprecated sys._clear_type_cache in #115152.

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

Linked PRs

• gh-129027: Raise DeprecationWarning for sys._clear_type_cache #129043

[encukou]

AFAICT, it is not soft-deprecated

As far as I can see, it's tested, documented, and only marked as deprecated in the docs. Isn't that what soft deprecation is?

[tomasr8]

AFAICT, it is not soft-deprecated

As far as I can see, it's tested, documented, and only marked as deprecated in the docs. Isn't that what soft deprecation is?

What I meant is, the docs don't specifically mention that it is soft-deprecated (I don't actually know if this is a requirement, some deprecated items mention soft-deprecation explicitly, does a lack of an explicit mention imply it is not soft-deprecated?). If it were soft-deprecated, we should not be adding a warning.