Thanks to visit codestin.com
Credit goes to github.com

Skip to content

gh-105578: Deprecate AnyStr in the docs #107116

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AlexWaygood merged 10 commits into from
Jul 31, 2023
Merged

gh-105578: Deprecate AnyStr in the docs #107116

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
9cd2b0f
Deprecate AnyStr in the docs
michael-the1 Jul 23, 2023
ebd0e7a
Add NEWS entry
michael-the1 Jul 23, 2023
d0b90d2
Add deprecation of AnyStr to What's New
michael-the1 Jul 23, 2023
4e07465
Add missing backticks and class markers
michael-the1 Jul 23, 2023
e517799
Fix formatting in What's New
michael-the1 Jul 23, 2023
0d2d4b0
Improve deprecation comments
michael-the1 Jul 25, 2023
2c948cb
Add deprecation of AnyStr to the Big Table at the bottom
michael-the1 Jul 25, 2023
c9df122
Add reference to type-params section
michael-the1 Jul 30, 2023
84259fa
Merge branch 'main' into deprecate-anystr-in-the-docs
AlexWaygood Jul 31, 2023
8e32e29
Small fixups
AlexWaygood Jul 31, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions Doc/library/typing.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -831,6 +831,11 @@ using ``[]``.

.. data:: AnyStr

.. deprecated:: 3.13
Comment thread
michael-the1 marked this conversation as resolved.
Outdated
Deprecated in favor of the new type parameter syntax. Use
``class A[T: (str, bytes)]: ...`` instead of importing ``AnyStr``. See
:pep:`695` for more details.
Comment thread
michael-the1 marked this conversation as resolved.
Outdated
Comment thread
michael-the1 marked this conversation as resolved.
Outdated

A :ref:`constrained type variable <typing-constrained-typevar>`.

Definition::
Expand Down
10 changes: 10 additions & 0 deletions Doc/whatsnew/3.13.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,11 @@ Deprecated
has yet to be supported by any major type checkers.
(Contributed by Alex Waygood in :gh:`106309`.)

* :class:`typing.AnyStr` is deprecated in docs since Python 3.13. The intention
is to remove ``AnyStr`` from ``__all__`` and emit a :exc:`DeprecationWarning`
in Python 3.16, and to remove ``AnyStr`` entirely in Python 3.18.
Comment thread
michael-the1 marked this conversation as resolved.
Outdated
(Contributed by Michael The in :gh:`107116`.)
Comment thread
michael-the1 marked this conversation as resolved.

* :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.
Expand Down Expand Up @@ -332,6 +337,11 @@ Pending Removal in Python 3.16
* :class:`array.array` ``'u'`` type (:c:type:`wchar_t`):
use the ``'w'`` type instead (``Py_UCS4``).

Pending Removal in Python 3.18
------------------------------

* :class:`typing.AnyStr`: Use the new type parameter syntax instead. See :pep:`695`. (:gh:`105578`)
Comment thread
michael-the1 marked this conversation as resolved.
Outdated

Pending Removal in Future Versions
----------------------------------

Expand Down
2 changes: 2 additions & 0 deletions Misc/NEWS.d/next/Library/2023-07-23-13-05-32.gh-issue-105578.XAQtyR.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
Deprecate :class:`typing.AnyStr` in favor of the new Type Parameter syntax.
See PEP 695.