From: Miro Hrončok <miro@hroncok.cz>
Date: Mon, 4 May 2020 19:02:00 +0000 (+0200)
Subject: bpo-40360: Add a What's New entry for lib2to3 pending deprecation (GH-19898)
X-Git-Tag: v3.9.0b1~183
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=18f1c60a1625d341a905c7e07367c32c08f222df;p=thirdparty%2FPython%2Fcpython.git

bpo-40360: Add a What's New entry for lib2to3 pending deprecation (GH-19898)
---

diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index cefaf5715d41..11e577baa8fb 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -608,6 +608,16 @@ Deprecated
 * Passing ``None`` as the first argument to the :func:`shlex.split` function
   has been deprecated.  (Contributed by Zackery Spytz in :issue:`33262`.)
 
+* The :mod:`lib2to3` module now emits a :exc:`PendingDeprecationWarning`.
+  Python 3.9 switched 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`_.
+  (Contributed by Carl Meyer in :issue:`40360`.)
+
+.. _LibCST: https://libcst.readthedocs.io/
+.. _parso: https://parso.readthedocs.io/
 
 Removed
 =======