commit | 4dfc5c53325d95fa9faf842fa367b6c696c8c92c | [log] [tgz] |
---|---|---|
author | Alex Waygood <Alex.Waygood@Gmail.com> | Wed Apr 12 13:22:33 2023 +0100 |
committer | GitHub <noreply@github.com> | Wed Apr 12 14:22:33 2023 +0200 |
tree | 27b3225fbc84046295799421e676f737acc4ba98 | |
parent | 31741e07fd32eb1d7f6e5f0e0f882da306838b4c [diff] |
Remove flake8-noqa from test-requirements.txt (#138)
The typing_extensions
module serves two related purposes:
typing.TypeGuard
is new in Python 3.10, but typing_extensions
allows users on previous Python versions to use it too.typing
module.New features may be added to typing_extensions
as soon as they are specified in a PEP that has been added to the python/peps repository. If the PEP is accepted, the feature will then be added to typing
for the next CPython release. No typing PEP has been rejected so far, so we haven't yet figured out how to deal with that possibility.
Starting with version 4.0.0, typing_extensions
uses Semantic Versioning. The major version is incremented for all backwards-incompatible changes. Therefore, it's safe to depend on typing_extensions
like this: typing_extensions >=x.y, <(x+1)
, where x.y
is the first version that includes all features you need.
typing_extensions
supports Python versions 3.7 and higher. In the future, support for older Python versions will be dropped some time after that version reaches end of life.
This module currently contains the following:
Experimental features
In the standard library since Python 3.12
In typing
since Python 3.11
assert_never
assert_type
clear_overloads
@dataclass_transform()
(see PEP 681)get_overloads
LiteralString
(see PEP 675)Never
NotRequired
(see PEP 655)reveal_type
Required
(see PEP 655)Self
(see PEP 673)TypeVarTuple
(see PEP 646; the typing_extensions
version supports the default=
argument from PEP 696)Unpack
(see PEP 646)In typing
since Python 3.10
In typing
since Python 3.9
Annotated
(see PEP 593)In typing
since Python 3.8
In typing
since Python 3.7
OrderedDict
In typing
since Python 3.5 or 3.6 (see the typing documentation for details)
AsyncContextManager
AsyncGenerator
AsyncIterable
AsyncIterator
Awaitable
ChainMap
ClassVar
(see PEP 526)ContextManager
Coroutine
Counter
DefaultDict
Deque
NewType
NoReturn
overload
Text
Type
TYPE_CHECKING
get_type_hints
The following have always been present in typing
, but the typing_extensions
versions provide additional features:
Certain objects were changed after they were added to typing
, and typing_extensions
provides a backport even on newer Python versions:
TypedDict
does not store runtime information about which (if any) keys are non-required in Python 3.8, and does not honor the total
keyword with old-style TypedDict()
in Python 3.9.0 and 3.9.1. TypedDict
also does not support multiple inheritance with typing.Generic
on Python <3.11.get_origin
and get_args
lack support for Annotated
in Python 3.8 and lack support for ParamSpecArgs
and ParamSpecKwargs
in 3.9.@final
was changed in Python 3.11 to set the .__final__
attribute.@overload
was changed in Python 3.11 to make function overloads introspectable at runtime. In order to access overloads with typing_extensions.get_overloads()
, you must use @typing_extensions.overload
.NamedTuple
was changed in Python 3.11 to allow for multiple inheritance with typing.Generic
.Any
at runtime. typing_extensions.Any
also provides this capability.TypeVar
gains two additional parameters, default=
and infer_variance=
, in the draft PEPs 695 and 696, which are being considered for inclusion in Python 3.12.There are a few types whose interface was modified between different versions of typing. For example, typing.Sequence
was modified to subclass typing.Reversible
as of Python 3.5.3.
These changes are not backported to prevent subtle compatibility issues when mixing the differing implementations of modified classes.
Certain types have incorrect runtime behavior due to limitations of older versions of the typing module:
ParamSpec
and Concatenate
will not work with get_args
and get_origin
. Certain PEP 612 special cases in user-defined Generic
s are also not available.These types are only guaranteed to work for static type checking.
To run tests, navigate into the appropriate source directory and run test_typing_extensions.py
.