https://github.com/python/cpython/commit/f10a1d80f24c7eabf039a106bda8b39a9f8eb3e6
commit: f10a1d80f24c7eabf039a106bda8b39a9f8eb3e6
branch: 3.13
author: Miss Islington (bot) <[email protected]>
committer: encukou <[email protected]>
date: 2026-03-10T10:32:06+01:00
summary:

[3.13] Document that PyType_GetModule returns a borrowed ref (GH-145612) 
(GH-145732)

(cherry picked from commit 44855458a423569eaea3df53fd5a0c0032da932d via 
30bcdcd379445b942e1278244bbce805dc32b5a2)

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

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 84a5b0fc3c0c77..1d94718b2d2313 100644
--- a/Doc/c-api/type.rst
+++ b/Doc/c-api/type.rst
@@ -259,6 +259,10 @@ Type Objects
    Return the module object associated with the given type when the type was
    created using :c:func:`PyType_FromModuleAndSpec`.
 
+   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.
+
    If no module is associated with the given type, sets :py:class:`TypeError`
    and returns ``NULL``.
 
diff --git a/Doc/data/refcounts.dat b/Doc/data/refcounts.dat
index 67f551cf6de442..9e0ce81627f255 100644
--- a/Doc/data/refcounts.dat
+++ b/Doc/data/refcounts.dat
@@ -2398,6 +2398,9 @@ PyType_GetFlags:PyTypeObject*:type:0:
 PyType_GetName:PyObject*::+1:
 PyType_GetName:PyTypeObject*:type:0:
 
+PyType_GetModule:PyObject*::0:
+PyType_GetModule:PyTypeObject*:type:0:
+
 PyType_GetModuleByDef:PyObject*::0:
 PyType_GetModuleByDef:PyTypeObject*:type:0:
 PyType_GetModuleByDef:PyModuleDef*:def::

_______________________________________________
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