Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

bpo-32892: Update the documentation for handling constants in AST. (GH-18514)

This commit is contained in:
Serhiy Storchaka 2020-02-17 11:03:00 +02:00 committed by GitHub
parent c33bdbb20c
commit 85a2eef473
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 13 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Doc/library/ast.rst
View File

@ -101,12 +101,16 @@ Node classes
node = ast.UnaryOp(ast.USub(), ast.Constant(5, lineno=0, col_offset=0),
lineno=0, col_offset=0)
.. versionchanged:: 3.8
Class :class:`ast.Constant` is now used for all constants.
.. deprecated:: 3.8
Class :class:`ast.Constant` is now used for all constants. Old classes
:class:`ast.Num`, :class:`ast.Str`, :class:`ast.Bytes`,
Old classes :class:`ast.Num`, :class:`ast.Str`, :class:`ast.Bytes`,
:class:`ast.NameConstant` and :class:`ast.Ellipsis` are still available,
but they will be removed in future Python releases.
but they will be removed in future Python releases. In the meanwhile,
instantiating them will return an instance of a different class.
.. _abstract-grammar:

6
Doc/whatsnew/3.8.rst
View File

@ -1940,6 +1940,12 @@ Changes in the Python API
:exc:`dbm.gnu.error` or :exc:`dbm.ndbm.error`) instead of :exc:`KeyError`.
(Contributed by Xiang Zhang in :issue:`33106`.)
* Simplified AST for literals. All constants will be represented as
:class:`ast.Constant` instances. Instantiating old classes ``Num``,
``Str``, ``Bytes``, ``NameConstant`` and ``Ellipsis`` will return
an instance of ``Constant``.
(Contributed by Serhiy Storchaka in :issue:`32892`.)
* :func:`~os.path.expanduser` on Windows now prefers the :envvar:`USERPROFILE`
environment variable and does not use :envvar:`HOME`, which is not normally
set for regular user accounts.