From: Petr Viktorin Date: Thu, 19 Jun 2025 07:00:41 +0000 (+0200) Subject: Document that PyType_GetModuleByDef returns a borrowed reference (GH-135666) X-Git-Tag: v3.15.0a1~1254 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=140731ff671395fb7a869c2784429c14dc83fb27;p=thirdparty%2FPython%2Fcpython.git Document that PyType_GetModuleByDef returns a borrowed reference (GH-135666) --- diff --git a/Doc/c-api/type.rst b/Doc/c-api/type.rst index 2176b8e492f3..5bdbff4e0ad9 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 ` 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 f5f02f0a79c9..99cc823c0c37 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: