From 64113a4ba801126028505c50a7383f3e9df29573 Mon Sep 17 00:00:00 2001 From: Ken Jin Date: Fri, 29 Apr 2022 11:22:25 +0700 Subject: gh-91873: Summarise deprecations in typing at the top level (GH-91864) --- Doc/library/typing.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index 4635da7..d4a6f32 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -36,6 +36,10 @@ New features are frequently added to the ``typing`` module. The `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 @@ -2644,3 +2648,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 | | | | ++----------------------------------+---------------+-------------------+----------------+ -- cgit v0.12