Deprecate for recommended five years

python · hugovk · Sep 29, 2025 · Sep 4, 2025 · Sep 8, 2025 · Sep 15, 2025
commit 6bb4cbe8d464cc3d18fd72f0ea7400386b38776e
diff --git a/Doc/deprecations/pending-removal-in-3.17.rst b/Doc/deprecations/pending-removal-in-3.17.rst
@@ -1,23 +1,22 @@
 Pending removal in Python 3.17
 ------------------------------
 
-* :mod:`collections.abc`:
-
-  - :class:`collections.abc.ByteString` is scheduled for removal in Python 3.17. Prefer
-    :class:`~collections.abc.Sequence` or :class:`~collections.abc.Buffer`. For use in
-    type annotations, prefer a union, like ``bytes | bytearray``, or
-    :class:`collections.abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)
-
 * :mod:`typing`:
 
   - Before Python 3.14, old-style unions were implemented using the private class
     ``typing._UnionGenericAlias``. This class is no longer needed for the implementation,
     but it has been retained for backward compatibility, with removal scheduled for Python
     3.17. Users should use documented introspection helpers like :func:`typing.get_origin`
     and :func:`typing.get_args` instead of relying on private implementation details.
-
   - :class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for removal in
     Python 3.17. Prefer :class:`~collections.abc.Sequence` or
     :class:`~collections.abc.Buffer`. For use in type annotations, prefer a union, like
     ``bytes | bytearray``, or :class:`collections.abc.Buffer`.
     (Contributed by Shantanu Jain in :gh:`91896`.)
+
+* :mod:`collections.abc`:
+
+  - :class:`collections.abc.ByteString` is scheduled for removal in Python 3.17. Prefer
+    :class:`~collections.abc.Sequence` or :class:`~collections.abc.Buffer`. For use in
+    type annotations, prefer a union, like ``bytes | bytearray``, or
+    :class:`collections.abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)
@@ -7360,7 +7360,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(argparse, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_csv.py b/Lib/test/test_csv.py
@@ -1608,7 +1608,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(csv, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_ctypes/test_macholib.py b/Lib/test/test_ctypes/test_macholib.py
@@ -114,7 +114,7 @@ def test_deprecated__version__(self):
 
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(ctypes.macholib, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_ipaddress.py b/Lib/test/test_ipaddress.py
@@ -2825,7 +2825,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(ipaddress, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_json/__init__.py b/Lib/test/test_json/__init__.py
@@ -51,7 +51,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(json, "__version__")
         self.assertEqual(cm.filename, __file__)

@@ -7238,7 +7238,7 @@ def test__all__(self):
 
 class TestModule(unittest.TestCase):
     def test_deprecated__version__and__date__(self):
-        msg = "is deprecated and slated for removal in Python 3.17"
+        msg = "is deprecated and slated for removal in Python 3.20"
         for attr in ("__version__", "__date__"):
             with self.subTest(attr=attr):
                 with self.assertWarnsRegex(DeprecationWarning, msg) as cm:

diff --git a/Lib/test/test_optparse.py b/Lib/test/test_optparse.py
@@ -1670,7 +1670,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(optparse, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_re.py b/Lib/test/test_re.py
@@ -3120,7 +3120,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(re, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_socketserver.py b/Lib/test/test_socketserver.py
@@ -515,7 +515,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(socketserver, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_tabnanny.py b/Lib/test/test_tabnanny.py
@@ -359,7 +359,7 @@ class TestModule(TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(tabnanny, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_tkinter/test_font.py b/Lib/test/test_tkinter/test_font.py
@@ -163,7 +163,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(font, "__version__")
         self.assertEqual(cm.filename, __file__)

diff --git a/Lib/test/test_ttk/__init__.py b/Lib/test/test_ttk/__init__.py
@@ -23,7 +23,7 @@ class TestModule(unittest.TestCase):
     def test_deprecated__version__(self):
         with self.assertWarnsRegex(
             DeprecationWarning,
-            "'__version__' is deprecated and slated for removal in Python 3.17",
+            "'__version__' is deprecated and slated for removal in Python 3.20",
         ) as cm:
             getattr(ttk, "__version__")
         self.assertEqual(cm.filename, __file__)