gh-146063: Add PyObject_CallFinalizerFromDealloc() to the limited C API (#146172)

Co-authored-by: Petr Viktorin <encukou@gmail.com>

Doc/data/stable_abi.dat

@@ -565,6 +565,7 @@ func,PyObject_ASCII,3.2,,
 func,PyObject_AsFileDescriptor,3.2,,
 func,PyObject_Bytes,3.2,,
 func,PyObject_Call,3.2,,
+func,PyObject_CallFinalizerFromDealloc,3.15,,
 func,PyObject_CallFunction,3.2,,
 func,PyObject_CallFunctionObjArgs,3.2,,
 func,PyObject_CallMethod,3.2,,

Doc/whatsnew/3.15.rst

@@ -2050,6 +2050,10 @@ New features
 
   (Contributed by Victor Stinner in :gh:`141510`.)
 
+* Add :c:func:`PyObject_CallFinalizerFromDealloc` function to the limited C
+  API.
+  (Contributed by Victor Stinner in :gh:`146063`.)
+
 * Add :c:func:`PySys_GetAttr`, :c:func:`PySys_GetAttrString`,
   :c:func:`PySys_GetOptionalAttr`, and :c:func:`PySys_GetOptionalAttrString`
   functions as replacements for :c:func:`PySys_GetObject`.

Include/cpython/object.h

@@ -307,7 +307,6 @@ Py_DEPRECATED(3.15) PyAPI_FUNC(PyObject*) _PyObject_GetAttrId(PyObject *, _Py_Id
 
 PyAPI_FUNC(PyObject **) _PyObject_GetDictPtr(PyObject *);
 PyAPI_FUNC(void) PyObject_CallFinalizer(PyObject *);
-PyAPI_FUNC(int) PyObject_CallFinalizerFromDealloc(PyObject *);
 
 PyAPI_FUNC(void) PyUnstable_Object_ClearWeakRefsNoCallbacks(PyObject *);
 

Include/object.h

@@ -782,6 +782,7 @@ PyAPI_FUNC(int) PyType_Freeze(PyTypeObject *type);
 #endif
 
 #if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= _Py_PACK_VERSION(3, 15)
+PyAPI_FUNC(int) PyObject_CallFinalizerFromDealloc(PyObject *);
 PyAPI_FUNC(PyObject *) PyType_GetModuleByToken(PyTypeObject *type,
                                                const void *token);
 PyAPI_FUNC(void *) PyObject_GetTypeData_DuringGC(PyObject *obj,

Lib/test/test_stable_abi_ctypes.py

@@ -552,6 +552,7 @@ SYMBOL_NAMES = (
     "PyObject_AsWriteBuffer",
     "PyObject_Bytes",
     "PyObject_Call",
+    "PyObject_CallFinalizerFromDealloc",
     "PyObject_CallFunction",
     "PyObject_CallFunctionObjArgs",
     "PyObject_CallMethod",

Misc/NEWS.d/next/C_API/2026-03-19-15-28-14.gh-issue-146063.Sc-1RU.rst

@@ -0,0 +1,2 @@
+Add :c:func:`PyObject_CallFinalizerFromDealloc` function to the limited C API.
+Patch by Victor Stinner.

Misc/stable_abi.toml

@@ -2691,7 +2691,6 @@
     added = '3.15'
 
 # PEP 757 import/export API.
-
 [function.PyLong_GetNativeLayout]
     added = '3.15'
 [function.PyLong_Export]
@@ -2715,3 +2714,6 @@
     # Note: The `_reserved` member of this struct is for interal use only.
     # (The definition of 'full-abi' was clarified when this entry was added.)
     struct_abi_kind = 'full-abi'
+
+[function.PyObject_CallFinalizerFromDealloc]
+    added = '3.15'

PC/python3dll.c

@@ -489,6 +489,7 @@ EXPORT_FUNC(PyObject_AsReadBuffer)
 EXPORT_FUNC(PyObject_AsWriteBuffer)
 EXPORT_FUNC(PyObject_Bytes)
 EXPORT_FUNC(PyObject_Call)
+EXPORT_FUNC(PyObject_CallFinalizerFromDealloc)
 EXPORT_FUNC(PyObject_CallFunction)
 EXPORT_FUNC(PyObject_CallFunctionObjArgs)
 EXPORT_FUNC(PyObject_CallMethod)