From dbbd0592af4dee736e3d3021c2c87d0ffc7b736a Mon Sep 17 00:00:00 2001 From: Petr Viktorin Date: Wed, 5 Aug 2026 14:54:14 +0200 Subject: [PATCH 1/2] Remove PyUnstable_ExecutableKinds and related macros --- Doc/c-api/frame.rst | 38 ------------------- Doc/whatsnew/3.16.rst | 9 +++++ Include/cpython/pyframe.h | 8 ---- ...-07-30-16-58-36.gh-issue-152105.1Jz1YH.rst | 6 +++ Python/frame.c | 8 ---- 5 files changed, 15 insertions(+), 54 deletions(-) create mode 100644 Misc/NEWS.d/next/C_API/2026-07-30-16-58-36.gh-issue-152105.1Jz1YH.rst diff --git a/Doc/c-api/frame.rst b/Doc/c-api/frame.rst index 70a610cea82d06..4159ff6e5965fb 100644 --- a/Doc/c-api/frame.rst +++ b/Doc/c-api/frame.rst @@ -243,41 +243,3 @@ Unless using :pep:`523`, you will not need this. Return the currently executing line number, or -1 if there is no line number. .. versionadded:: 3.12 - - -.. c:var:: const PyTypeObject *PyUnstable_ExecutableKinds - - An array of executable kinds (executor types) for frames, used for internal - debugging and tracing. - - Tools like debuggers and profilers can use this to identify the type of execution - context associated with a frame (such as to filter out internal frames). - The entries are indexed by the following constants: - - .. list-table:: - :header-rows: 1 - :widths: auto - - * - Constant - - Description - * - .. c:macro:: PyUnstable_EXECUTABLE_KIND_SKIP - - The frame is internal (For example: inlined) and should be skipped by tools. - * - .. c:macro:: PyUnstable_EXECUTABLE_KIND_PY_FUNCTION - - The frame corresponds to a standard Python function. - * - .. c:macro:: PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION - - The frame corresponds to a function defined in native code. - * - .. c:macro:: PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR - - The frame corresponds to a method on a class instance. - - Note that reading the executable kind from a frame is currently only - possible with undocumented internal APIs. - - .. versionadded:: 3.13 - - -.. c:macro:: PyUnstable_EXECUTABLE_KINDS - - The number of entries in :c:data:`PyUnstable_ExecutableKinds`. - - .. versionadded:: 3.13 - diff --git a/Doc/whatsnew/3.16.rst b/Doc/whatsnew/3.16.rst index 90ab6758a264cd..210bcafe65f5e9 100644 --- a/Doc/whatsnew/3.16.rst +++ b/Doc/whatsnew/3.16.rst @@ -872,3 +872,12 @@ Deprecated C APIs Removed C APIs -------------- + +* The :c:var:`!PyUnstable_ExecutableKinds` array, as well as the macros + :c:macro:`!PyUnstable_EXECUTABLE_KIND_SKIP`, + :c:macro:`!PyUnstable_EXECUTABLE_KIND_PY_FUNCTION`, + :c:macro:`!PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION`, + :c:macro:`!PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR` and + :c:macro:`!PyUnstable_EXECUTABLE_KINDS`, were removed. + + (Contributed by Peters Bierma and Viktorin in :gh:`152105`.) diff --git a/Include/cpython/pyframe.h b/Include/cpython/pyframe.h index 51529763923ec3..24a947de1ede1e 100644 --- a/Include/cpython/pyframe.h +++ b/Include/cpython/pyframe.h @@ -35,11 +35,3 @@ PyAPI_FUNC(int) PyUnstable_InterpreterFrame_GetLasti(struct _PyInterpreterFrame /* Returns the currently executing line number, or -1 if there is no line number. * Does not raise an exception. */ PyAPI_FUNC(int) PyUnstable_InterpreterFrame_GetLine(struct _PyInterpreterFrame *frame); - -#define PyUnstable_EXECUTABLE_KIND_SKIP 0 -#define PyUnstable_EXECUTABLE_KIND_PY_FUNCTION 1 -#define PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION 3 -#define PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR 4 -#define PyUnstable_EXECUTABLE_KINDS 5 - -PyAPI_DATA(const PyTypeObject *) const PyUnstable_ExecutableKinds[PyUnstable_EXECUTABLE_KINDS+1]; diff --git a/Misc/NEWS.d/next/C_API/2026-07-30-16-58-36.gh-issue-152105.1Jz1YH.rst b/Misc/NEWS.d/next/C_API/2026-07-30-16-58-36.gh-issue-152105.1Jz1YH.rst new file mode 100644 index 00000000000000..5440389ce5bbb8 --- /dev/null +++ b/Misc/NEWS.d/next/C_API/2026-07-30-16-58-36.gh-issue-152105.1Jz1YH.rst @@ -0,0 +1,6 @@ +Remove the :c:var:`!PyUnstable_ExecutableKinds` array, as well as the macros +:c:macro:`!PyUnstable_EXECUTABLE_KIND_SKIP`, +:c:macro:`!PyUnstable_EXECUTABLE_KIND_PY_FUNCTION`, +:c:macro:`!PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION`, +:c:macro:`!PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR` and +:c:macro:`!PyUnstable_EXECUTABLE_KINDS`, from the C API. diff --git a/Python/frame.c b/Python/frame.c index ff81eb0b3020c7..ba8222417d208c 100644 --- a/Python/frame.c +++ b/Python/frame.c @@ -149,11 +149,3 @@ PyUnstable_InterpreterFrame_GetLine(_PyInterpreterFrame *frame) int addr = _PyInterpreterFrame_LASTI(frame) * sizeof(_Py_CODEUNIT); return PyCode_Addr2Line(_PyFrame_GetCode(frame), addr); } - -const PyTypeObject *const PyUnstable_ExecutableKinds[PyUnstable_EXECUTABLE_KINDS+1] = { - [PyUnstable_EXECUTABLE_KIND_SKIP] = &_PyNone_Type, - [PyUnstable_EXECUTABLE_KIND_PY_FUNCTION] = &PyCode_Type, - [PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION] = &PyMethod_Type, - [PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR] = &PyMethodDescr_Type, - [PyUnstable_EXECUTABLE_KINDS] = NULL, -}; From 30c513976d1c3807392153e111c7cdfe78ddd4bf Mon Sep 17 00:00:00 2001 From: Petr Viktorin Date: Wed, 5 Aug 2026 15:52:56 +0200 Subject: [PATCH 2/2] Record removed IDs --- Doc/tools/removed-ids.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Doc/tools/removed-ids.txt b/Doc/tools/removed-ids.txt index 7796d15f4d2735..3801e6d31199d6 100644 --- a/Doc/tools/removed-ids.txt +++ b/Doc/tools/removed-ids.txt @@ -23,6 +23,13 @@ using/configure.html: cmdoption-with-system-libmpdec library/symtable.html: symtable.Class.get_methods library/sys.html: sys._enablelegacywindowsfsencoding c-api/import.html: c.PyImport_LazyImportsMode.PyImport_LAZY_NONE +c-api/frame.html: c.PyUnstable_EXECUTABLE_KINDS +c-api/frame.html: c.PyUnstable_ExecutableKinds +c-api/frame.html: c.PyUnstable_ExecutableKinds.PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION +c-api/frame.html: c.PyUnstable_ExecutableKinds.PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR +c-api/frame.html: c.PyUnstable_ExecutableKinds.PyUnstable_EXECUTABLE_KIND_PY_FUNCTION +c-api/frame.html: c.PyUnstable_ExecutableKinds.PyUnstable_EXECUTABLE_KIND_SKIP + ## Old names for grammar tokens reference/expressions.html: grammar-token-python-grammar-comp_for