Skip to content

gh-91873: Summarise deprecations in typing at the top level #91864

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Apr 29, 2022
Merged

gh-91873: Summarise deprecations in typing at the top level #91864

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
25d9e0d
Summarise deprecations in typing at the top level
Fidget-Spinner Apr 23, 2022
83a024e
remove standard collections from the deprecated list
Fidget-Spinner Apr 23, 2022
0b6c5f7
add back standard collections, remove version removed
Fidget-Spinner Apr 23, 2022
d77400e
Address reviews by Alex and Shantanu
Fidget-Spinner Apr 24, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions Doc/library/typing.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,10 @@ New features are frequently added to the ``typing`` module.
The `typing_extensions <https://pypi.org/project/typing-extensions/>`_ package
provides backports of these new features to older versions of Python.

For a summary of deprecated features and a deprecation timeline, please see
`Deprecation Timeline of Major Features`_.


.. _relevant-peps:

Relevant PEPs
Expand Down Expand Up @@ -2630,3 +2634,20 @@ Constant
(see :pep:`563`).

.. versionadded:: 3.5.2

Deprecation Timeline of Major Features
======================================

Certain features in ``typing`` are deprecated and may be removed in a future
version of Python. The following table summarizes major deprecations for your
convenience. This is subject to change, and not all deprecations are listed.

+----------------------------------+---------------+-------------------+----------------+
| Feature | Deprecated in | Projected removal | PEP/issue |
+==================================+===============+===================+================+
| ``typing.io`` and ``typing.re`` | 3.8 | 3.12 | :issue:`38291` |
| submodules | | | |
+----------------------------------+---------------+-------------------+----------------+
| ``typing`` versions of standard | 3.9 | Undecided | :pep:`585` |
| collections | | | |
+----------------------------------+---------------+-------------------+----------------+