From 6f18b86fda516df9ba7614423ba5c8d0fcf366ba Mon Sep 17 00:00:00 2001 From: Alex Waygood Date: Fri, 6 May 2022 11:15:18 +0100 Subject: gh-92332: Docs-only deprecation of `typing.Text` (GH-92351) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com> --- Doc/library/typing.rst | 7 +++++++ Doc/whatsnew/3.11.rst | 6 ++++++ .../next/Library/2022-05-05-22-46-52.gh-issue-92332.Fv9CJx.rst | 2 ++ 3 files changed, 15 insertions(+) create mode 100644 Misc/NEWS.d/next/Library/2022-05-05-22-46-52.gh-issue-92332.Fv9CJx.rst diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index 8808559..005a515 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -1976,6 +1976,11 @@ Other concrete types .. versionadded:: 3.5.2 + .. deprecated:: 3.11 + Python 2 is no longer supported, and most type checkers also no longer + support type checking Python 2 code. Users should now use + :class:`str` instead of ``Text`` wherever possible. + Abstract Base Classes --------------------- @@ -2687,3 +2692,5 @@ convenience. This is subject to change, and not all deprecations are listed. | ``typing`` versions of standard | 3.9 | Undecided | :pep:`585` | | collections | | | | +----------------------------------+---------------+-------------------+----------------+ +| ``typing.Text`` | 3.11 | Undecided | :gh:`92332` | ++----------------------------------+---------------+-------------------+----------------+ diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 19ac867..f679100 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -1202,6 +1202,12 @@ Deprecated For now, a deprecation warning is raised for such syntax. (Contributed by Serhiy Storchaka in :gh:`91760`.) +* :class:`typing.Text`, which exists solely to provide compatibility support + between Python 2 and Python 3 code, is now deprecated. Its removal is + currently unplanned, but users are encouraged to use :class:`str` instead + wherever possible. + (Contributed by Alex Waygood in :gh:`92332`.) + Removed ======= diff --git a/Misc/NEWS.d/next/Library/2022-05-05-22-46-52.gh-issue-92332.Fv9CJx.rst b/Misc/NEWS.d/next/Library/2022-05-05-22-46-52.gh-issue-92332.Fv9CJx.rst new file mode 100644 index 0000000..1d055bb --- /dev/null +++ b/Misc/NEWS.d/next/Library/2022-05-05-22-46-52.gh-issue-92332.Fv9CJx.rst @@ -0,0 +1,2 @@ +Deprecate :class:`typing.Text` (removal of the class is currently not +planned). Patch by Alex Waygood. -- cgit v0.12