Skip to content

[doc] bpo-45680: Disambiguate __getitem__ and __class_getitem__ in the data model. #29389

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ambv merged 11 commits into from
Nov 18, 2021
Merged

[doc] bpo-45680: Disambiguate __getitem__ and __class_getitem__ in the data model. #29389

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
020d168
[doc] bpo-45680: Disambiguate ``__getitem__`` and ``__class_getitem__…
AlexWaygood Nov 3, 2021
fe66943
Update 2021-11-03-14-30-55.bpo-45680.UBpWzY.rst
AlexWaygood Nov 3, 2021
32d7751
Delete news entry
AlexWaygood Nov 3, 2021
efa0731
Address review
AlexWaygood Nov 4, 2021
7ae4fac
Improve links to ``typing`` docs
AlexWaygood Nov 4, 2021
8bc6b7c
Add link to glossary definition
AlexWaygood Nov 4, 2021
b01b0c9
Address second review
AlexWaygood Nov 7, 2021
ca568d5
Revise changes to ``__getitem__``
AlexWaygood Nov 7, 2021
c1955d7
Improve code snippet
AlexWaygood Nov 8, 2021
ace22fd
Remove trailing whitespace
AlexWaygood Nov 8, 2021
f8ea20a
Fix CI failures
AlexWaygood Nov 11, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Improve links to typing docs
  • Loading branch information
@AlexWaygood
AlexWaygood committed Nov 4, 2021
commit 7ae4fac3de3d68a1a5c2c3f911290b595993e8ab
1 change: 1 addition & 0 deletions Doc/library/typing.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -257,6 +257,7 @@ called :class:`TypeVar`.
def first(l: Sequence[T]) -> T: # Generic function
return l[0]

.. _user-defined-generics:

User-defined generic types
==========================
Expand Down
6 changes: 3 additions & 3 deletions Doc/reference/datamodel.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2228,9 +2228,9 @@ For example, the annotation ``list[int]`` might be used to signify a
:ref:`Generic Alias Types<types-genericalias>`
Documentation for objects representing parameterized generic classes

:class:`typing.Generic`
Inherit from :class:`typing.Generic` to implement generic classes that
can be parameterized at runtime and understood by static type-checkers.
:ref:`Generics`, :ref:`user-defined generics<user-defined-generics>` and :class:`typing.Generic`
Documentation on how to implement generic classes that can be
parameterized at runtime and understood by static type-checkers.

A class can generally only be parameterized if it defines the special
classmethod ``__class_getitem__()``.
Expand Down