Deprecate the old C API

Author: vstinner

Doc/deprecations/c-api-pending-removal-in-3.20.rst

@@ -7,3 +7,10 @@ Pending removal in Python 3.20
   representation.
 
 * Macros :c:macro:`!Py_MATH_PIl` and :c:macro:`!Py_MATH_El`.
+
+* :c:func:`!_PyInterpreterState_GetEvalFrameFunc` and
+  :c:func:`!_PyInterpreterState_SetEvalFrameFunc` functions are deprecated
+  and will be removed in Python 3.20. Use
+  :c:func:`PyUnstable_InterpreterState_GetEvalFrameFunc` and
+  :c:func:`PyUnstable_InterpreterState_SetEvalFrameFunc` instead.
+  (Contributed by Victor Stinner in :gh:`141518`.)

Doc/whatsnew/3.11.rst

@@ -2305,7 +2305,7 @@ Porting to Python 3.11
   be used for ``size``.
   (Contributed by Kumar Aditya in :issue:`46608`.)
 
-* :c:func:`_PyFrameEvalFunction` now takes ``_PyInterpreterFrame*``
+* :c:func:`!_PyFrameEvalFunction` now takes ``_PyInterpreterFrame*``
   as its second parameter, instead of ``PyFrameObject*``.
   See :pep:`523` for more details of how to use this function pointer type.
 

Doc/whatsnew/3.15.rst

@@ -1233,6 +1233,13 @@ Deprecated C APIs
   since 3.15 and will be removed in 3.20.
   (Contributed by Sergey B Kirpichev in :gh:`141004`.)
 
+* :c:func:`!_PyInterpreterState_GetEvalFrameFunc` and
+  :c:func:`!_PyInterpreterState_SetEvalFrameFunc` functions are deprecated
+  and will be removed in Python 3.20. Use
+  :c:func:`PyUnstable_InterpreterState_GetEvalFrameFunc` and
+  :c:func:`PyUnstable_InterpreterState_SetEvalFrameFunc` instead.
+  (Contributed by Victor Stinner in :gh:`141518`.)
+
 
 .. Add C API deprecations above alphabetically, not here at the end.
 

Include/cpython/pystate.h

@@ -312,5 +312,16 @@ PyAPI_FUNC(void) PyUnstable_InterpreterState_SetEvalFrameFunc(
 
 // Deprecated aliases kept for backward compatibility
 #define _PyFrameEvalFunction PyUnstable_FrameEvalFunction
-#define _PyInterpreterState_GetEvalFrameFunc PyUnstable_InterpreterState_GetEvalFrameFunc
-#define _PyInterpreterState_SetEvalFrameFunc PyUnstable_InterpreterState_SetEvalFrameFunc
+
+Py_DEPRECATED(3.15) static inline PyUnstable_FrameEvalFunction
+_PyInterpreterState_GetEvalFrameFunc(PyInterpreterState *interp)
+{
+    return PyUnstable_InterpreterState_GetEvalFrameFunc(interp);
+}
+
+Py_DEPRECATED(3.15) static inline void
+_PyInterpreterState_SetEvalFrameFunc(PyInterpreterState *interp,
+                                     PyUnstable_FrameEvalFunction eval_frame)
+{
+    PyUnstable_InterpreterState_SetEvalFrameFunc(interp, eval_frame);
+}

Misc/NEWS.d/3.9.0a5.rst

@@ -1305,6 +1305,6 @@ and undefined PY_SSIZE_T_CLEAN whwn an exception is set.
 .. section: C API
 
 Add a private API to get and set the frame evaluation function: add
-:c:func:`_PyInterpreterState_GetEvalFrameFunc` and
-:c:func:`_PyInterpreterState_SetEvalFrameFunc` C functions. The
-:c:type:`_PyFrameEvalFunction` function type now takes a *tstate* parameter.
+:c:func:`!_PyInterpreterState_GetEvalFrameFunc` and
+:c:func:`!_PyInterpreterState_SetEvalFrameFunc` C functions. The
+:c:type:`!_PyFrameEvalFunction` function type now takes a *tstate* parameter.