Skip to content

Commit 64113a4

Browse files
gh-91873: Summarise deprecations in typing at the top level (GH-91864)
1 parent ea2f5bc commit 64113a4

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

Doc/library/typing.rst

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,10 @@ New features are frequently added to the ``typing`` module.
3636
The `typing_extensions <https://pypi.org/project/typing-extensions/>`_ package
3737
provides backports of these new features to older versions of Python.
3838

39+
For a summary of deprecated features and a deprecation timeline, please see
40+
`Deprecation Timeline of Major Features`_.
41+
42+
3943
.. _relevant-peps:
4044

4145
Relevant PEPs
@@ -2644,3 +2648,20 @@ Constant
26442648
(see :pep:`563`).
26452649

26462650
.. versionadded:: 3.5.2
2651+
2652+
Deprecation Timeline of Major Features
2653+
======================================
2654+
2655+
Certain features in ``typing`` are deprecated and may be removed in a future
2656+
version of Python. The following table summarizes major deprecations for your
2657+
convenience. This is subject to change, and not all deprecations are listed.
2658+
2659+
+----------------------------------+---------------+-------------------+----------------+
2660+
| Feature | Deprecated in | Projected removal | PEP/issue |
2661+
+==================================+===============+===================+================+
2662+
| ``typing.io`` and ``typing.re`` | 3.8 | 3.12 | :issue:`38291` |
2663+
| submodules | | | |
2664+
+----------------------------------+---------------+-------------------+----------------+
2665+
| ``typing`` versions of standard | 3.9 | Undecided | :pep:`585` |
2666+
| collections | | | |
2667+
+----------------------------------+---------------+-------------------+----------------+

0 commit comments

Comments
 (0)