From 1a146f7a4163e59443f204b74457194da5f95971 Mon Sep 17 00:00:00 2001 From: Petr Viktorin Date: Tue, 10 Mar 2026 10:06:08 +0100 Subject: [PATCH] [3.14] Document that PyType_GetModule returns a borrowed ref (GH-145612) (GH-145682) (cherry picked from commit 30bcdcd379445b942e1278244bbce805dc32b5a2) Co-authored-by: Petr Viktorin (cherry picked from commit 44855458a423569eaea3df53fd5a0c0032da932d) --- Doc/c-api/type.rst | 4 ++++ Doc/data/refcounts.dat | 3 +++ 2 files changed, 7 insertions(+) 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 ` 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::