[Python-checkins] bpo-44263: Mention PyType_Ready in the gc protocol warning (GH-26445)
miss-islington
webhook-mailer at python.org
Fri May 28 23:53:48 EDT 2021
https://github.com/python/cpython/commit/7bd1304d49a110700b3f079e4b2dd1052a23bde4
commit: 7bd1304d49a110700b3f079e4b2dd1052a23bde4
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2021-05-28T20:53:40-07:00
summary:
bpo-44263: Mention PyType_Ready in the gc protocol warning (GH-26445)
(cherry picked from commit 43cf7c864a2941b3f8f823e5928721dd286b7778)
Co-authored-by: Pablo Galindo <Pablogsal at gmail.com>
files:
M Doc/c-api/gcsupport.rst
M Doc/c-api/type.rst
diff --git a/Doc/c-api/gcsupport.rst b/Doc/c-api/gcsupport.rst
index 76f9ab53b4f31..f821b45090c47 100644
--- a/Doc/c-api/gcsupport.rst
+++ b/Doc/c-api/gcsupport.rst
@@ -38,8 +38,9 @@ Constructors for container types must conform to two rules:
a :c:member:`~PyTypeObject.tp_traverse` handler or explicitly use one
from its subclass or subclasses.
- Some APIs like :c:func:`PyType_FromSpecWithBases` or
- :c:func:`PyType_FromSpec` will automatically populate the
+ When calling :c:func:`PyType_Ready` or some of the APIs that indirectly
+ call it like :c:func:`PyType_FromSpecWithBases` or
+ :c:func:`PyType_FromSpec` the interpreter will automatically populate the
:c:member:`~PyTypeObject.tp_flags`, :c:member:`~PyTypeObject.tp_traverse`
and :c:member:`~PyTypeObject.tp_clear` fields if the type inherits from a
class that implements the garbage collector protocol and the child class
diff --git a/Doc/c-api/type.rst b/Doc/c-api/type.rst
index d694b8caf1799..d7f4bd67def13 100644
--- a/Doc/c-api/type.rst
+++ b/Doc/c-api/type.rst
@@ -97,6 +97,15 @@ Type Objects
from a type's base class. Return ``0`` on success, or return ``-1`` and sets an
exception on error.
+ .. note::
+ If some of the base classes implements the GC protocol and the provided
+ type does not include the :const:`Py_TPFLAGS_HAVE_GC` in its flags, then
+ the GC protocol will be automatically implemented from its parents. On
+ the contrary, if the type being created does include
+ :const:`Py_TPFLAGS_HAVE_GC` in its flags then it **must** implement the
+ GC protocol itself by at least implementing the
+ :c:member:`~PyTypeObject.tp_traverse` handle.
+
.. c:function:: void* PyType_GetSlot(PyTypeObject *type, int slot)
Return the function pointer stored in the given slot. If the
@@ -168,13 +177,6 @@ The following functions and structs are used to create
The associated module is not inherited by subclasses; it must be specified
for each class individually.
- If some of the bases in *bases* implements the GC protocol and the type being
- created does not include the :const:`Py_TPFLAGS_HAVE_GC` in the flags included in
- *spec*, then the GC protocol will be automatically implemented from its parents. On
- the contrary, if the type being created does include :const:`Py_TPFLAGS_HAVE_GC` in
- its flags then it *must* implement the GC protocol itself by at least including a slot
- for :c:member:`~PyTypeObject.tp_traverse` in *spec*.
-
This function calls :c:func:`PyType_Ready` on the new type.
.. versionadded:: 3.9
More information about the Python-checkins
mailing list