deprecate c api

Author: xuantengh

Include/ceval.h

@@ -19,7 +19,7 @@ PyAPI_FUNC(PyObject *) PyEval_EvalCodeEx(PyObject *co,
 
 PyAPI_FUNC(PyObject *) PyEval_GetBuiltins(void);
 PyAPI_FUNC(PyObject *) PyEval_GetGlobals(void);
-PyAPI_FUNC(PyObject *) PyEval_GetLocals(void);
+Py_DEPRECATED(3.14) PyAPI_FUNC(PyObject *) PyEval_GetLocals(void);
 PyAPI_FUNC(PyFrameObject *) PyEval_GetFrame(void);
 
 PyAPI_FUNC(PyObject *) PyEval_GetFrameBuiltins(void);

Python/ceval.c

@@ -2599,6 +2599,12 @@ _PyEval_GetBuiltinId(_Py_Identifier *name)
 PyObject *
 PyEval_GetLocals(void)
 {
+    if (PyErr_WarnEx(PyExc_DeprecationWarning,
+        "PyEval_GetLocals() is deprecated in Python 3.14 "
+        "and will be removed in 3.16.", 1))
+    {
+        return NULL;
+    }
     // We need to return a borrowed reference here, so some tricks are needed
     PyThreadState *tstate = _PyThreadState_GET();
      _PyInterpreterFrame *current_frame = _PyThreadState_GetFrame(tstate);