mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-29 03:35:31 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

[3.9] bpo-41370: Add note about ForwardRefs and PEP585 generic types in docs (GH-25183) (GH-25184)

Browse source 
(cherry picked from commit 2b5913b4ee)


Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>

Automerge-Triggered-By: GH:gvanrossum
This commit is contained in:
Miss Islington (bot) 2021-04-04 08:36:21 -07:00 • committed by GitHub
parent c7b0feca25
commit d56bcf915b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/library/typing.rst
View file

@ -1710,10 +1710,15 @@ Introspection helpers
.. class:: ForwardRef .. class:: ForwardRef
A class used for internal typing representation of string forward references. A class used for internal typing representation of string forward references.
For example, ``list["SomeClass"]`` is implicitly transformed into For example, ``List["SomeClass"]`` is implicitly transformed into
``list[ForwardRef("SomeClass")]``. This class should not be instantiated by ``List[ForwardRef("SomeClass")]``. This class should not be instantiated by
a user, but may be used by introspection tools. a user, but may be used by introspection tools.
.. note::
:pep:`585` generic types such as ``list["SomeClass"]`` will not be
implicitly transformed into ``list[ForwardRef("SomeClass")]`` and thus
will not automatically resolve to ``list[SomeClass]``.
.. versionadded:: 3.7.4 .. versionadded:: 3.7.4
Constant Constant