gh-129027: Raise DeprecationWarning for sys._clear_type_cache

Author: srinivasreddy

Python/clinic/sysmodule.c.h

@@ -2122,13 +2122,20 @@ extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
 /*[clinic input]
 sys._clear_type_cache
 
-Clear the internal type lookup cache.
+[deprecated] Clear the internal type lookup cache.
+
+This function is deprecated and will be removed in future python versions. May we should specify 3.15?
 [clinic start generated code]*/
 
 static PyObject *
 sys__clear_type_cache_impl(PyObject *module)
-/*[clinic end generated code: output=20e48ca54a6f6971 input=127f3e04a8d9b555]*/
+/*[clinic end generated code: output=20e48ca54a6f6971 input=d427a1feaacc355c]*/
 {
+    if (PyErr_WarnEx(PyExc_DeprecationWarning,
+                     "sys._clear_type_cache() is deprecated "
+                     "and will be removed in future python versions", 1) < 0) {
+        return NULL;
+    }
     PyType_ClearCache();
     Py_RETURN_NONE;
 }