[Python-checkins] bpo-42840: Document providing kwargs to type. (GH-24173)

miss-islington webhook-mailer at python.org
Wed Mar 31 20:10:40 EDT 2021


https://github.com/python/cpython/commit/b3c1e2c493e67f84b1034ac6c49492a459b0736d
commit: b3c1e2c493e67f84b1034ac6c49492a459b0736d
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-03-31T17:10:36-07:00
summary:

bpo-42840: Document providing kwargs to type. (GH-24173)


Co-authored-by: Ken Jin <28750310+Fidget-Spinner at users.noreply.github.com>
(cherry picked from commit 72fcd14a82369ed32a5846d76f50e3026cf4eec2)

Co-authored-by: Erik Soma <stillusingirc at gmail.com>

files:
M Doc/library/functions.rst

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 990fc10c8cc97..ef51782205b45 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1675,7 +1675,7 @@ are always available.  They are listed here in alphabetical order.
 
 
 .. class:: type(object)
-           type(name, bases, dict)
+           type(name, bases, dict, **kwds)
 
    .. index:: object: type
 
@@ -1704,6 +1704,13 @@ are always available.  They are listed here in alphabetical order.
 
    See also :ref:`bltin-type-objects`.
 
+   Keyword arguments provided to the three argument form are passed to the
+   appropriate metaclass machinery (usually :meth:`~object.__init_subclass__`)
+   in the same way that keywords in a class
+   definition (besides *metaclass*) would.
+
+   See also :ref:`class-customization`.
+
    .. versionchanged:: 3.6
       Subclasses of :class:`type` which don't override ``type.__new__`` may no
       longer use the one-argument form to get the type of an object.



More information about the Python-checkins mailing list