From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 22 Aug 2021 18:29:59 +0000 (-0700)
Subject: bpo-44926: `get_type_hints`: Add note about type aliases with forward refs (GH-27859... 
X-Git-Tag: v3.10.0rc2~73
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9ffe582a018a2babd14e874ae2b169370633fe33;p=thirdparty%2FPython%2Fcpython.git

bpo-44926: `get_type_hints`: Add note about type aliases with forward refs (GH-27859) (GH-27860)

(cherry picked from commit 16b9be4861e007ad483611ba0479feb2b90ea783)

Co-authored-by: Maximilian Hils <git@maximilianhils.com>
---

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index e8d7c9ee01bd..47d6c3a2e389 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -2013,6 +2013,13 @@ Introspection helpers
            'name': Annotated[str, 'some marker']
        }
 
+   .. note::
+
+      :func:`get_type_hints` does not work with imported
+      :ref:`type aliases <type-aliases>` that include forward references.
+      Enabling postponed evaluation of annotations (:pep:`563`) may remove
+      the need for most forward references.
+
    .. versionchanged:: 3.9
       Added ``include_extras`` parameter as part of :pep:`593`.