From 25d9e0ddf7bfeddf0db848576ea59ed6ef0c0b7c Mon Sep 17 00:00:00 2001
From: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com>
Date: Sun, 24 Apr 2022 00:52:39 +0800
Subject: [PATCH 1/4] Summarise deprecations in typing at the top level
---
Doc/library/typing.rst | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 2f62193e65c293..ae830dc96b2e1d 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -36,6 +36,24 @@ New features are frequently added to the ``typing`` module.
The `typing_extensions `_ package
provides backports of these new features to older versions of Python.
+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 | 3.14 | :pep:`585` |
+| collections | | | |
++----------------------------------+---------------+-------------------+----------------+
+
+
.. _relevant-peps:
Relevant PEPs
From 83a024e69fe3c07a2a4acc8937dbb46031ce10b1 Mon Sep 17 00:00:00 2001
From: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com>
Date: Sun, 24 Apr 2022 02:11:42 +0800
Subject: [PATCH 2/4] remove standard collections from the deprecated list
---
Doc/library/typing.rst | 3 ---
1 file changed, 3 deletions(-)
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index ae830dc96b2e1d..381d0c13550dbf 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -49,9 +49,6 @@ convenience. This is subject to change, and not all deprecations are listed.
| ``typing.io`` and ``typing.re`` | 3.8 | 3.12 | :issue:`38291` |
| submodules | | | |
+----------------------------------+---------------+-------------------+----------------+
-| ``typing`` versions of standard | 3.9 | 3.14 | :pep:`585` |
-| collections | | | |
-+----------------------------------+---------------+-------------------+----------------+
.. _relevant-peps:
From 0b6c5f72dd940bb444242569bd89325bb0f8a120 Mon Sep 17 00:00:00 2001
From: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com>
Date: Sun, 24 Apr 2022 02:21:12 +0800
Subject: [PATCH 3/4] add back standard collections, remove version removed
---
Doc/library/typing.rst | 3 +++
1 file changed, 3 insertions(+)
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 381d0c13550dbf..82cb0fd6bd2b13 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -49,6 +49,9 @@ convenience. This is subject to change, and not all deprecations are listed.
| ``typing.io`` and ``typing.re`` | 3.8 | 3.12 | :issue:`38291` |
| submodules | | | |
+----------------------------------+---------------+-------------------+----------------+
+| ``typing`` versions of standard | 3.9 | not planned | :pep:`585` |
+| collections | | | |
++----------------------------------+---------------+-------------------+----------------+
.. _relevant-peps:
From d77400e3500d06d85b3436fc35b222600d7c8bfb Mon Sep 17 00:00:00 2001
From: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com>
Date: Mon, 25 Apr 2022 00:34:37 +0800
Subject: [PATCH 4/4] Address reviews by Alex and Shantanu
---
Doc/library/typing.rst | 35 +++++++++++++++++++----------------
1 file changed, 19 insertions(+), 16 deletions(-)
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 82cb0fd6bd2b13..440a67d0b45838 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -36,22 +36,8 @@ New features are frequently added to the ``typing`` module.
The `typing_extensions `_ package
provides backports of these new features to older versions of Python.
-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 | not planned | :pep:`585` |
-| collections | | | |
-+----------------------------------+---------------+-------------------+----------------+
+For a summary of deprecated features and a deprecation timeline, please see
+`Deprecation Timeline of Major Features`_.
.. _relevant-peps:
@@ -2648,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 | | | |
++----------------------------------+---------------+-------------------+----------------+