Skip to content

bpo-40360: [doc] Rephrase deprecation note about lib2to3 #28122

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
ambv merged 2 commits into from
Sep 2, 2021
Merged

bpo-40360: [doc] Rephrase deprecation note about lib2to3 #28122

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
503e547
bpo-40360: [doc] Rephrase deprecation note about lib2to3
ambv Sep 2, 2021
4872f1f
Be more specific about removal time
ambv Sep 2, 2021
File filter

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions Doc/library/2to3.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -464,12 +464,15 @@ and off individually. They are described here in more detail.

--------------

.. deprecated:: 3.10
Python 3.9 will switch to a PEG parser (see :pep:`617`), and Python 3.10 may
include new language syntax that is not parsable by lib2to3's LL(1) parser.
The ``lib2to3`` module may be removed from the standard library in a future
Python version. Consider third-party alternatives such as `LibCST`_ or
`parso`_.
.. deprecated:: 3.11
Python 3.9 switched to a PEG parser (see :pep:`617`) while lib2to3 is
using a less flexible LL(1) parser. Python 3.10 includes new language
syntax that is not parsable by lib2to3's LL(1) parser (see :pep:`634`).
The ``lib2to3`` module was marked pending for deprecation in Python 3.9
(raising :exc:`PendingDeprecationWarning` on import) and fully deprecated
in Python 3.11 (raising :exc:`DeprecationWarning`).
It will be removed from the standard library in a future Python version.
Consider third-party alternatives such as `LibCST`_ or `parso`_.

.. note::

Expand Down