From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sun, 11 Jan 2026 15:59:19 +0000 (+0100) Subject: [3.13] gh-86139: Correct NamedTuple and TypedDict's type in typing.rst (GH-143692... X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0dc3c08950b5e04e88f165ab77f35d6d70509532;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-86139: Correct NamedTuple and TypedDict's type in typing.rst (GH-143692) (#143697) Co-authored-by: AN Long Co-authored-by: Alex Waygood --- diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index febabb5bb6d0..4384707dc399 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -2257,7 +2257,7 @@ These functions and classes should not be used directly as annotations. Their intended purpose is to be building blocks for creating and declaring types. -.. class:: NamedTuple +.. function:: NamedTuple Typed version of :func:`collections.namedtuple`. @@ -2330,6 +2330,10 @@ types. Removed the ``_field_types`` attribute in favor of the more standard ``__annotations__`` attribute which has the same information. + .. versionchanged:: 3.9 + ``NamedTuple`` is now a function rather than a class. + It can still be used as a class base, as described above. + .. versionchanged:: 3.11 Added support for generic namedtuples. @@ -2482,10 +2486,10 @@ types. for more details. -.. class:: TypedDict(dict) +.. function:: TypedDict Special construct to add type hints to a dictionary. - At runtime it is a plain :class:`dict`. + At runtime ":class:`!TypedDict` instances" are simply :class:`dicts `. ``TypedDict`` declares a dictionary type that expects all of its instances to have a certain set of keys, where each key is @@ -2708,6 +2712,10 @@ types. .. versionadded:: 3.8 + .. versionchanged:: 3.9 + ``TypedDict`` is now a function rather than a class. + It can still be used as a class base, as described above. + .. versionchanged:: 3.11 Added support for marking individual keys as :data:`Required` or :data:`NotRequired`. See :pep:`655`.