https://github.com/python/cpython/commit/aee789cf976ff10b2a77d5ba16d4326e5b621841
commit: aee789cf976ff10b2a77d5ba16d4326e5b621841
branch: 3.14
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: encukou <encu...@gmail.com>
date: 2025-06-19T09:17:53+02:00
summary:
[3.14] Document that PyType_GetModuleByDef returns a borrowed reference
(GH-135666) (GH-135701)
(cherry picked from commit 140731ff671395fb7a869c2784429c14dc83fb27)
Co-authored-by: Petr Viktorin <encu...@gmail.com>
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 29f430d4786248..7db5ec6712c4ed 100644
--- a/Doc/data/refcounts.dat
+++ b/Doc/data/refcounts.dat
@@ -2388,6 +2388,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 -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: arch...@mail-archive.com
