[Python-checkins] gh-105578: Document that `AnyStr` is deprecated in py313 (#107116)
AlexWaygood
webhook-mailer at python.org
Mon Jul 31 11:43:57 EDT 2023
https://github.com/python/cpython/commit/a22ff8e11c114e0c4c54c57b9e7f7520db9d5163
commit: a22ff8e11c114e0c4c54c57b9e7f7520db9d5163
branch: main
author: Michael The <michael-the1 at users.noreply.github.com>
committer: AlexWaygood <Alex.Waygood at Gmail.com>
date: 2023-07-31T15:43:53Z
summary:
gh-105578: Document that `AnyStr` is deprecated in py313 (#107116)
It will not be removed until Python 3.18.
files:
A Misc/NEWS.d/next/Library/2023-07-23-13-05-32.gh-issue-105578.XAQtyR.rst
M Doc/library/typing.rst
M Doc/whatsnew/3.13.rst
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 539203f1d7136..f96a805cef7b2 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -864,6 +864,16 @@ using ``[]``.
def greet_proper(cond: bool) -> str | bytes:
return "hi there!" if cond else b"greetings!"
+ .. deprecated-removed:: 3.13 3.18
+ Deprecated in favor of the new :ref:`type parameter syntax <type-params>`.
+ Use ``class A[T: (str, bytes)]: ...`` instead of importing ``AnyStr``. See
+ :pep:`695` for more details.
+
+ In Python 3.16, ``AnyStr`` will be removed from ``typing.__all__``, and
+ deprecation warnings will be emitted at runtime when it is accessed or
+ imported from ``typing``. ``AnyStr`` will be removed from ``typing``
+ in Python 3.18.
+
.. data:: LiteralString
Special type that includes only literal strings.
@@ -3700,3 +3710,7 @@ convenience. This is subject to change, and not all deprecations are listed.
- 3.13
- 3.15
- :gh:`106309`
+ * - :data:`typing.AnyStr`
+ - 3.13
+ - 3.18
+ - :gh:`105578`
diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
index e20832a3a4c30..8fb4e6cfdf14c 100644
--- a/Doc/whatsnew/3.13.rst
+++ b/Doc/whatsnew/3.13.rst
@@ -196,6 +196,12 @@ Deprecated
has yet to be supported by any major type checkers.
(Contributed by Alex Waygood in :gh:`106309`.)
+ * :data:`typing.AnyStr` is deprecated. In Python 3.16, it will be removed from
+ ``typing.__all__``, and a :exc:`DeprecationWarning` will be emitted when it
+ is imported or accessed. It will be removed entirely in Python 3.18. Use
+ the new :ref:`type parameter syntax <type-params>` instead.
+ (Contributed by Michael The in :gh:`107116`.)
+
* :mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()``
methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes.
They will be removed in Python 3.15.
diff --git a/Misc/NEWS.d/next/Library/2023-07-23-13-05-32.gh-issue-105578.XAQtyR.rst b/Misc/NEWS.d/next/Library/2023-07-23-13-05-32.gh-issue-105578.XAQtyR.rst
new file mode 100644
index 0000000000000..4a03f5c35ff6c
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2023-07-23-13-05-32.gh-issue-105578.XAQtyR.rst
@@ -0,0 +1,2 @@
+Deprecate :class:`typing.AnyStr` in favor of the new Type Parameter syntax.
+See PEP 695.
More information about the Python-checkins
mailing list