From: Jelle Zijlstra Date: Tue, 4 May 2021 16:48:41 +0000 (-0700) Subject: [3.9] bpo-44001: improve Literal documentation (GH-25877). (#25897) X-Git-Tag: v3.9.6~134 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ab0a54adad8ddf488ccfb92970be9e4027673d19;p=thirdparty%2FPython%2Fcpython.git [3.9] bpo-44001: improve Literal documentation (GH-25877). (#25897) (cherry picked from commit 87109f4d85c93a870ee8aa0d2b394547d4636b17) Co-authored-by: Jelle Zijlstra --- diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index b136da00a070..06a8b813c2b4 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -656,10 +656,10 @@ These can be used as types in annotations using ``[]``, each having a unique syn .. versionadded:: 3.8 .. versionchanged:: 3.9.1 - ``Literal`` now de-duplicates parameters. Equality comparison of + ``Literal`` now de-duplicates parameters. Equality comparisons of ``Literal`` objects are no longer order dependent. ``Literal`` objects will now raise a :exc:`TypeError` exception during equality comparisons - if one of their parameters are not :term:`immutable`. + if one of their parameters are not :term:`hashable`. .. data:: ClassVar diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst index cb492e458c6d..7f790e5bd755 100644 --- a/Doc/whatsnew/3.9.rst +++ b/Doc/whatsnew/3.9.rst @@ -1493,7 +1493,7 @@ and to match the behavior of static type checkers specified in the PEP. now ``False``. To support this change, the internally used type cache now supports differentiating types. 4. ``Literal`` objects will now raise a :exc:`TypeError` exception during - equality comparisons if one of their parameters are not :term:`immutable`. + equality comparisons if any of their parameters are not :term:`hashable`. Note that declaring ``Literal`` with mutable parameters will not throw an error::