https://github.com/python/cpython/commit/d1e3cae9d6d55abd763dfca18877c2bd0db13ad0
commit: d1e3cae9d6d55abd763dfca18877c2bd0db13ad0
branch: main
author: Victor Stinner <[email protected]>
committer: vstinner <[email protected]>
date: 2026-11-20T12:44:43Z
summary:

gh-158401: Implement Py_INCREF() as function call in stable ABI (#162120)

Py_INCREF(), Py_XINCREF(), Py_DECREF() and Py_XDECREF() are now
implemented as function calls on all limited C API versions.
Previously, they were only implemented as function calls on the
limited C API version 3.12 or newer.

Previously, if a C extension was built with the limited C API version
3.11 or newer, Py_DECREF() was implemented as "op->ob_refcnt--". But
Python 3.12 made Py_DECREF() more complicated to implement immortal
objects in an efficient way. "op->ob_refcnt--" can convert an
immortal object to a mortal object which causes various kinds of
nasty bugs.

Co-authored-by: Hood Chatham <[email protected]>
Co-authored-by: Petr Viktorin <[email protected]>

files:
A Misc/NEWS.d/next/C_API/2026-11-16-17-25-12.gh-issue-158401.ADBBRG.rst
M Include/refcount.h

diff --git a/Include/refcount.h b/Include/refcount.h
index 9b681f6a254a42a..dc47a49cfbbb180 100644
--- a/Include/refcount.h
+++ b/Include/refcount.h
@@ -254,13 +254,12 @@ PyAPI_FUNC(void) _Py_DecRef(PyObject *);
 
 static inline Py_ALWAYS_INLINE void Py_INCREF(PyObject *op)
 {
-#if (defined(Py_LIMITED_API) && (Py_LIMITED_API+0 >= 0x030c0000 || 
defined(Py_REF_DEBUG))) \
-    || defined(_Py_OPAQUE_PYOBJECT)
-    // Stable ABI implements Py_INCREF() as a function call on limited C API
-    // version 3.12 and newer, abi3t, and on Python built in debug mode.
-    // _Py_IncRef() was added to Python 3.10.0a7, use Py_IncRef() on older 
versions.
-    // Py_IncRef() accepts NULL whereas _Py_IncRef() doesn't.
-#  if Py_LIMITED_API+0 >= 0x030a00A7
+#if defined(Py_LIMITED_API) || defined(_Py_OPAQUE_PYOBJECT)
+    // gh-158401: The stable ABI now implements Py_INCREF() as a function
+    // call on all limited C API versions. _Py_IncRef() was added to Python
+    // 3.10.0a7, use Py_IncRef() on older versions. Py_IncRef() accepts NULL,
+    // whereas _Py_IncRef() doesn't.
+#  if Py_LIMITED_API+0 >= _Py_PACK_VERSION(3, 10)
     _Py_IncRef(op);
 #  else
     Py_IncRef(op);
@@ -324,14 +323,13 @@ PyAPI_FUNC(void) _Py_MergeZeroLocalRefcount(PyObject *);
 #endif  // Py_GIL_DISABLED
 #endif  // Py_LIMITED_API
 
-#if (defined(Py_LIMITED_API) && (Py_LIMITED_API+0 >= 0x030c0000 || 
defined(Py_REF_DEBUG))) \
-    || defined(_Py_OPAQUE_PYOBJECT)
-// Stable ABI implements Py_DECREF() as a function call on limited C API
-// version 3.12 and newer, abi3t, and on Python built in debug mode.
-// _Py_DecRef() was added to Python 3.10.0a7, use Py_DecRef() on older 
versions.
-// Py_DecRef() accepts NULL whereas _Py_DecRef() doesn't.
+#if defined(Py_LIMITED_API) || defined(_Py_OPAQUE_PYOBJECT)
+// gh-158401: The stable ABI now implements Py_DECREF() as a function call
+// on all limited C API versions. _Py_DecRef() was added to Python 3.10.0a7,
+// use Py_DecRef() on older versions. Py_DecRef() accepts NULL, whereas
+// _Py_DecRef() doesn't.
 static inline void Py_DECREF(PyObject *op) {
-#  if Py_LIMITED_API+0 >= 0x030a00A7
+#  if Py_LIMITED_API+0 >= _Py_PACK_VERSION(3, 10)
     _Py_DecRef(op);
 #  else
     Py_DecRef(op);
diff --git 
a/Misc/NEWS.d/next/C_API/2026-11-16-17-25-12.gh-issue-158401.ADBBRG.rst 
b/Misc/NEWS.d/next/C_API/2026-11-16-17-25-12.gh-issue-158401.ADBBRG.rst
new file mode 100644
index 000000000000000..f1b59a75095b2a0
--- /dev/null
+++ b/Misc/NEWS.d/next/C_API/2026-11-16-17-25-12.gh-issue-158401.ADBBRG.rst
@@ -0,0 +1,4 @@
+:c:func:`Py_INCREF`, :c:func:`Py_XINCREF`, :c:func:`Py_DECREF` and
+:c:func:`Py_XDECREF` are now implemented as function calls on all limited C
+API versions.  Previously, they were only implemented as function calls on
+the limited C API version 3.12 or newer. Patch by Victor Stinner:

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to