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
+22 −0
Merged

gh-105578: Deprecate AnyStr in the docs #107116

Show file tree
Hide file tree
Changes from 1 commit
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
Prev Previous commit
Small fixups
  • Loading branch information
@AlexWaygood
AlexWaygood committed Jul 31, 2023
commit 8e32e2968f601b3a4e8a08c9872d2412174013d3
20 changes: 10 additions & 10 deletions Doc/library/typing.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -831,16 +831,6 @@ using ``[]``.

.. data:: AnyStr

.. 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.

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

Definition::
Expand Down Expand Up @@ -874,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.
Expand Down
5 changes: 0 additions & 5 deletions Doc/whatsnew/3.13.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -346,11 +346,6 @@ 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 :ref:`type parameter syntax <type-params>` instead. See :pep:`695`. (:gh:`105578`)

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

Expand Down