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]
