https://github.com/python/cpython/commit/4f006ffdb9c87c54cea9226c23fb1b97120a01a9 commit: 4f006ffdb9c87c54cea9226c23fb1b97120a01a9 branch: 3.13 author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com> committer: AA-Turner <9087854+aa-tur...@users.noreply.github.com> date: 2025-04-30T16:58:19Z summary:
[3.13] Apply 'mod' role to typing module (GH-133201) (#133217) Apply 'mod' role to typing module (GH-133201) (cherry picked from commit 2b67db7ce3d73c9ad905125f9a602657afe9be9f) Co-authored-by: Rafael Fontenelle <rffontene...@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+aa-tur...@users.noreply.github.com> files: M Doc/library/typing.rst diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index bba7114fc1ff33..ee51f81846e9b3 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -665,7 +665,7 @@ through a simple assignment:: User-defined generics for parameter expressions are also supported via parameter specification variables in the form ``[**P]``. The behavior is consistent with type variables' described above as parameter specification variables are -treated by the typing module as a specialized type variable. The one exception +treated by the :mod:`!typing` module as a specialized type variable. The one exception to this is that a list of types can be used to substitute a :class:`ParamSpec`:: >>> class Z[T, **P]: ... # T is a TypeVar; P is a ParamSpec @@ -706,7 +706,7 @@ are intended primarily for static type checking. A user-defined generic class can have ABCs as base classes without a metaclass conflict. Generic metaclasses are not supported. The outcome of parameterizing -generics is cached, and most types in the typing module are :term:`hashable` and +generics is cached, and most types in the :mod:`!typing` module are :term:`hashable` and comparable for equality. @@ -2685,7 +2685,7 @@ types. Protocols --------- -The following protocols are provided by the typing module. All are decorated +The following protocols are provided by the :mod:`!typing` module. All are decorated with :func:`@runtime_checkable <runtime_checkable>`. .. class:: SupportsAbs @@ -3384,7 +3384,7 @@ Deprecated aliases ------------------ This module defines several deprecated aliases to pre-existing -standard library classes. These were originally included in the typing +standard library classes. These were originally included in the :mod:`!typing` module in order to support parameterizing these generic classes using ``[]``. However, the aliases became redundant in Python 3.9 when the corresponding pre-existing classes were enhanced to support ``[]`` (see @@ -3397,7 +3397,7 @@ interpreter for these aliases. If at some point it is decided to remove these deprecated aliases, a deprecation warning will be issued by the interpreter for at least two releases -prior to removal. The aliases are guaranteed to remain in the typing module +prior to removal. The aliases are guaranteed to remain in the :mod:`!typing` module without deprecation warnings until at least Python 3.14. Type checkers are encouraged to flag uses of the deprecated types if the _______________________________________________ Python-checkins mailing list -- python-checkins@python.org To unsubscribe send an email to python-checkins-le...@python.org https://mail.python.org/mailman3/lists/python-checkins.python.org/ Member address: arch...@mail-archive.com