[Python-checkins] bpo-38291: Remove mention of typing.io and typing.re again (GH-26113)
gvanrossum
webhook-mailer at python.org
Mon Jun 14 10:45:28 EDT 2021
https://github.com/python/cpython/commit/8a76683cfb842e12b57f6d276839f6c68fd94e1a
commit: 8a76683cfb842e12b57f6d276839f6c68fd94e1a
branch: main
author: Sebastian Rittau <srittau at rittau.biz>
committer: gvanrossum <gvanrossum at gmail.com>
date: 2021-06-14T07:45:19-07:00
summary:
bpo-38291: Remove mention of typing.io and typing.re again (GH-26113)
They were originally removed in GH-10173 per bpo-35089, but then
readded in GH-21574. Cf. bpo-38291 for decision to remove.
files:
A Misc/NEWS.d/next/Documentation/2021-06-14-09-20-37.bpo-38291.VMYa_Q.rst
M Doc/library/typing.rst
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index ba79bb7ed75ff7..e9980a7745d694 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -1488,7 +1488,11 @@ Other concrete types
Generic type ``IO[AnyStr]`` and its subclasses ``TextIO(IO[str])``
and ``BinaryIO(IO[bytes])``
represent the types of I/O streams such as returned by
- :func:`open`. These types are also in the ``typing.io`` namespace.
+ :func:`open`.
+
+ .. deprecated-removed:: 3.8 3.12
+ These types are also in the ``typing.io`` namespace, which was
+ never supported by type checkers and will be removed.
.. class:: Pattern
Match
@@ -1498,7 +1502,11 @@ Other concrete types
:func:`re.match`. These types (and the corresponding functions)
are generic in ``AnyStr`` and can be made specific by writing
``Pattern[str]``, ``Pattern[bytes]``, ``Match[str]``, or
- ``Match[bytes]``. These types are also in the ``typing.re`` namespace.
+ ``Match[bytes]``.
+
+ .. deprecated-removed:: 3.8 3.12
+ These types are also in the ``typing.re`` namespace, which was
+ never supported by type checkers and will be removed.
.. deprecated:: 3.9
Classes ``Pattern`` and ``Match`` from :mod:`re` now support ``[]``.
diff --git a/Misc/NEWS.d/next/Documentation/2021-06-14-09-20-37.bpo-38291.VMYa_Q.rst b/Misc/NEWS.d/next/Documentation/2021-06-14-09-20-37.bpo-38291.VMYa_Q.rst
new file mode 100644
index 00000000000000..23ce35eb176d9d
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2021-06-14-09-20-37.bpo-38291.VMYa_Q.rst
@@ -0,0 +1,2 @@
+Mark ``typing.io`` and ``typing.re`` as deprecated since Python 3.8 in the
+documentation. They were never properly supported by type checkers.
More information about the Python-checkins
mailing list