An AST unparser for Python.
This is a factored out version of unparse found in the Python source distribution; under Demo/parser in Python 2 and under Tools/parser in Python 3.
Basic example:
import inspect import ast import astunparse # get back the source code astunparse.unparse(ast.parse(inspect.getsource(ast))) # get a pretty-printed dump of the AST astunparse.dump(ast.parse(inspect.getsource(ast)))
This library is single-source compatible with Python 2.6 through Python 3.5. It is authored by the Python core developers; I have simply merged the Python 2.7 and the Python 3.5 source and test suites, and added a wrapper. This factoring out is to provide a library implementation that supports both versions.
Added to this is a pretty-printing dump utility function.
The test suite both runs specific tests and also roundtrips much of the standard library.
Extensions and Alternatives
Similar projects include:
None of these roundtrip much of the standard library and fail several of the basic tests in the test_unparse test suite.
This library uses mature and core maintained code instead of trying to patch existing libraries. The unparse and the test_unparse modules are under the PSF license.
Extensions include:
typed-astunparse: extends astunparse to support type annotations.
Documentation: http://astunparse.rtfd.org.
Features
unparses Python AST.
pretty-prints AST.
Changelog
Here’s the recent changes to AST Unparser.
1.6.3 - 2019-12-22
Add full support for Python 3.8
1.6.2 - 2019-01-19
Add support for the Constant node in Python 3.8
Add tests to the sdist
1.6.1 - 2018-10-03
Fix the roundtripping of very complex f-strings.
1.6.0 - 2018-09-30
Python 3.7 compatibility
1.5.0 - 2017-02-05
Python 3.6 compatibility
bugfix: correct argparser option type
1.4.0 - 2016-06-24
Support for the async keyword
Support for unparsing “Interactive” and “Expression” nodes
1.3.0 - 2016-01-17
Python 3.5 compatibility
1.2.0 - 2014-04-03
Python 2.6 through 3.4 compatibility
A new function dump is added to return a pretty-printed version of the AST. It’s also available when running python -m astunparse as the --dump argument.
1.1.0 - 2014-04-01
unparse will return the source code for an AST. It is pretty feature-complete, and round-trips the stdlib, and is compatible with Python 2.7 and Python 3.4.
Running python -m astunparse will print the round-tripped source for any python files given as argument.
1 maintainer
Metadata
1 maintainer
Release files for astunparse 1.6.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| astunparse-1.6.3.tar.gz | 18.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| astunparse-1.6.3-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 31.0 kB
Release files / astunparse-1.6.3.tar.gz
| Download URL | astunparse-1.6.3.tar.gz |
|---|---|
| Size | 18.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5ad93a8456f0d084c3456d059fd9a92cce667963232cbf763eac3bc5b7940872
|
|
BLAKE2b-256 checksum How to use checksums |
f3af4182184d3c338792894f34a62672919db7ca008c89abee9b564dd34d8029
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.5
|
Release files / astunparse-1.6.3-py2.py3-none-any.whl
| Download URL | astunparse-1.6.3-py2.py3-none-any.whl |
|---|---|
| Size | 12.7 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
c2652417f2c8b5bb325c885ae329bdf3f86424075c4fd1a128674bc6fba4b8e8
|
|
BLAKE2b-256 checksum How to use checksums |
2b0313dde6512ad7b4557eb792fbcf0c653af6076b81e5941d36ec61f7ce6028
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.5
|
