https://github.com/python/cpython/commit/2cf68dbe2907d13a8d34a6df42ec5b506dd4f1d9
commit: 2cf68dbe2907d13a8d34a6df42ec5b506dd4f1d9
branch: 3.12
author: Shantanu <[email protected]>
committer: hauntsaninja <[email protected]>
date: 2024-03-01T01:56:06Z
summary:
[3.12] gh-115881: Document feature_version limitations (#115980) (#116173)
files:
M Doc/library/ast.rst
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 793e9ee1c8e409..6be58747be751c 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -2178,12 +2178,15 @@ and classes for traversing abstract syntax trees:
modified to correspond to :pep:`484` "signature type comments",
e.g. ``(str, int) -> List[str]``.
- Also, setting ``feature_version`` to a tuple ``(major, minor)``
- will attempt to parse using that Python version's grammar.
- Currently ``major`` must equal to ``3``. For example, setting
- ``feature_version=(3, 4)`` will allow the use of ``async`` and
- ``await`` as variable names. The lowest supported version is
- ``(3, 4)``; the highest is ``sys.version_info[0:2]``.
+ Setting ``feature_version`` to a tuple ``(major, minor)`` will result in
+ a "best-effort" attempt to parse using that Python version's grammar.
+ For example, setting ``feature_version=(3, 9)`` will attempt to disallow
+ parsing of :keyword:`match` statements.
+ Currently ``major`` must equal to ``3``. The lowest supported version is
+ ``(3, 4)`` (and this may increase in future Python versions);
+ the highest is ``sys.version_info[0:2]``. "Best-effort" attempt means there
+ is no guarantee that the parse (or success of the parse) is the same as
+ when run on the Python version corresponding to ``feature_version``.
If source contains a null character (``\0``), :exc:`ValueError` is raised.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
