]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
[3.10] [doc] bpo-45680: Disambiguate ``__getitem__`` and ``__class_getitem__`` in...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Thu, 18 Nov 2021 17:34:08 +0000 (09:34 -0800)
committerGitHub <noreply@github.com>
Thu, 18 Nov 2021 17:34:08 +0000 (18:34 +0100)
commitfde9f61e70bc38850783c81bf7c80c764ba6d9fa
tree1aa680c580914adc35f2ef09ce3eeee78005d72b
parent252d83cbf1bf0a6ac22a1347e760cd3e551bb834
[3.10] [doc] bpo-45680: Disambiguate ``__getitem__`` and ``__class_getitem__`` in the  data model (GH-29389) (GH-29620)

The documentation explaining Python's data model does not adequately explain
the differences between ``__getitem__`` and ``__class_getitem__``, nor does it
explain when each is called. There is an attempt at explaining
``__class_getitem__`` in the documentation for ``GenericAlias`` objects, but
this does not give sufficient clarity into how the method works. Moreover, it
is the wrong place for that information to be found; the explanation of
``__class_getitem__`` should be in the documentation explaining the data model.

This PR has been split off from GH-29335.
(cherry picked from commit 31b3a70edb1216bdc8fab3b2eafd8ddb00487f41)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Ɓukasz Langa <lukasz@langa.pl>
Doc/library/typing.rst
Doc/reference/datamodel.rst
Doc/tools/susp-ignored.csv