https://github.com/python/cpython/commit/140731ff671395fb7a869c2784429c14dc83fb27
commit: 140731ff671395fb7a869c2784429c14dc83fb27
branch: main
author: Petr Viktorin <[email protected]>
committer: encukou <[email protected]>
date: 2025-06-19T09:00:41+02:00
summary:
Document that PyType_GetModuleByDef returns a borrowed reference (GH-135666)
files:
M Doc/c-api/type.rst
M Doc/data/refcounts.dat
diff --git a/Doc/c-api/type.rst b/Doc/c-api/type.rst
index 2176b8e492f306..5bdbff4e0ad990 100644
--- a/Doc/c-api/type.rst
+++ b/Doc/c-api/type.rst
@@ -282,6 +282,10 @@ Type Objects
and other places where a method's defining class cannot be passed using the
:c:type:`PyCMethod` calling convention.
+ The returned reference is :term:`borrowed <borrowed reference>` from *type*,
+ and will be valid as long as you hold a reference to *type*.
+ Do not release it with :c:func:`Py_DECREF` or similar.
+
.. versionadded:: 3.11
.. c:function:: int PyType_GetBaseByToken(PyTypeObject *type, void *token,
PyTypeObject **result)
diff --git a/Doc/data/refcounts.dat b/Doc/data/refcounts.dat
index f5f02f0a79c93d..99cc823c0c3772 100644
--- a/Doc/data/refcounts.dat
+++ b/Doc/data/refcounts.dat
@@ -2385,6 +2385,10 @@ PyType_GetFlags:PyTypeObject*:type:0:
PyType_GetName:PyObject*::+1:
PyType_GetName:PyTypeObject*:type:0:
+PyType_GetModuleByDef:PyObject*::0:
+PyType_GetModuleByDef:PyTypeObject*:type:0:
+PyType_GetModuleByDef:PyModuleDef*:def::
+
PyType_GetQualName:PyObject*::+1:
PyType_GetQualName:PyTypeObject*:type:0:
_______________________________________________
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]
