From: soreavis <263610811+soreavis@users.noreply.github.com>
Date: Sun, 19 Jul 2026 15:31:59 +0000 (+0200)
Subject: gh-62534: Document that three-argument type() does not call __prepare__ (GH-154028)
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5625b187ab528e10dcaa21726a7c95b110d97190;p=thirdparty%2FPython%2Fcpython.git

gh-62534: Document that three-argument type() does not call __prepare__ (GH-154028)

The three-argument form of type() skips the metaclass __prepare__
method, which is called by the class statement machinery rather than
by the metaclass call itself. Say so in the type() entry and point to
types.new_class() for dynamic class creation with the appropriate
metaclass, as directed in the issue thread.
---

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 8dbebf7048b5..f45ab397e936 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -2179,6 +2179,11 @@ are always available.  They are listed here in alphabetical order.
    in the same way that keywords in a class
    definition (besides *metaclass*) would.
 
+   Unlike a :keyword:`class` statement, the three argument form does not
+   call the metaclass ``__prepare__`` method (see :ref:`prepare`).  Use
+   :func:`types.new_class` to dynamically create a class using the
+   appropriate metaclass.
+
    See also :ref:`class-customization`.
 
    .. versionchanged:: 3.6