Skip to content

bpo-38870: Expose a function to unparse an ast object in the ast module #17302

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
merged 15 commits into from
Nov 24, 2019
Merged

bpo-38870: Expose a function to unparse an ast object in the ast module #17302

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
0a65c6a
bpo-38870: Expose a function to unparse an ast object in the ast module
pablogsal Nov 20, 2019
1014fa8
Update what's new
pablogsal Nov 20, 2019
eb28c5d
Fix typo in class name
pablogsal Nov 20, 2019
2d93781
Use NodeVisitor instead of handmade dispatch() method in _Unparser
isidentical Nov 21, 2019
838e7ef
make _Unparser.enter a context manager and remove leave
isidentical Nov 21, 2019
e9434a9
Make INFSTR a private constant, add interleave as a method to _Unparser
isidentical Nov 21, 2019
59f1efc
Modernize assert checks into ValueErrors, test that cases
isidentical Nov 21, 2019
0b39840
Remove IO-like object API for _Unparser, convert it to node-based API
isidentical Nov 21, 2019
68d1a32
Add Batuhan Taskaya as a contributor to exposing unparse
isidentical Nov 21, 2019
ba425c1
Modernize test_unparse with using sole pathlib instead of mixing os.path
isidentical Nov 21, 2019
e158d34
Instead of using super, call traverse in all items so in the future w…
isidentical Nov 22, 2019
fc0e8ac
test only Lib/ and Lib/test (some tests in lib2to3 is including py2)
isidentical Nov 22, 2019
260cd5d
use ast.parse() for consistency in future tests
isidentical Nov 22, 2019
28471e9
Add formating, simplify the test file and cosmetic changes
pablogsal Nov 24, 2019
96c9aad
Rewrite some docstrings
pablogsal Nov 24, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions Doc/library/ast.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,19 @@ and classes for traversing abstract syntax trees:
Added ``type_comments``, ``mode='func_type'`` and ``feature_version``.


.. function:: unparse(ast_obj)

Unparse an :class:`ast.AST` object and generate a string with code
that would produce an equivalent :class:`ast.AST` object if parsed
back with :func:`ast.parse`.

.. warning::
The produced code string will not necesarily be equal to the original
code that generated the :class:`ast.AST` object.

.. versionadded:: 3.9


.. function:: literal_eval(node_or_string)

Safely evaluate an expression node or a string containing a Python literal or
Expand Down
5 changes: 5 additions & 0 deletions Doc/whatsnew/3.9.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,11 @@ Added the *indent* option to :func:`~ast.dump` which allows it to produce a
multiline indented output.
(Contributed by Serhiy Storchaka in :issue:`37995`.)

Added the :func:`ast.unparse` as a function in the :mod:`ast` module that can
be used to unparse an :class:`ast.AST` object and produce a string with code
that would produce an equivalent :class:`ast.AST` object when parsed.
(Contributed by Pablo Galindo and Batuhan Taskaya in :issue:`38870`.)

asyncio
-------

Expand Down
Loading