summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Lee <michael.lee.0x2a@gmail.com>2018-09-26 15:13:28 (GMT)
committerIvan Levkivskyi <levkivskyi@gmail.com>2018-09-26 15:13:28 (GMT)
commit130717fe58abb2ab9e7938207df0c130a2562747 (patch)
treee4d1e736ea15853c2d68918381537beeff6e47c5
parentbb8165172ac2ef8c7092e8e82928cc7f5f310ab3 (diff)
downloadcpython-130717fe58abb2ab9e7938207df0c130a2562747.zip
cpython-130717fe58abb2ab9e7938207df0c130a2562747.tar.gz
cpython-130717fe58abb2ab9e7938207df0c130a2562747.tar.bz2
Clarify that Type[SomeTypeVar] is legal (#9585)
Currently, the docs state that when doing `Type[X]`, X is only allowed to be a class, a union of classes, and Any. This pull request amends that sentence to clarify X may also be a typevar (or a union involving classes, Any, and TypeVars).
-rw-r--r--Doc/library/typing.rst9
1 files changed, 6 insertions, 3 deletions
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 23a6415..268adc0 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -169,6 +169,8 @@ It is possible to declare the return type of a callable without specifying
the call signature by substituting a literal ellipsis
for the list of arguments in the type hint: ``Callable[..., ReturnType]``.
+.. _generics:
+
Generics
--------
@@ -183,7 +185,7 @@ subscription to denote expected types for container elements.
def notify_by_email(employees: Sequence[Employee],
overrides: Mapping[str, str]) -> None: ...
-Generics can be parametrized by using a new factory available in typing
+Generics can be parameterized by using a new factory available in typing
called :class:`TypeVar`.
::
@@ -488,8 +490,9 @@ The module defines the following classes, functions and decorators:
required to handle this particular case may change in future revisions of
:pep:`484`.
- The only legal parameters for :class:`Type` are classes, unions of classes, and
- :data:`Any`. For example::
+ The only legal parameters for :class:`Type` are classes, :data:`Any`,
+ :ref:`type variables <generics>`, and unions of any of these types.
+ For example::
def new_non_team_user(user_class: Type[Union[BaseUser, ProUser]]): ...