astor – AST observe/rewrite

PyPI:: https://pypi.org/project/astor/
Documentation:: https://astor.readthedocs.io
Source:: https://github.com/berkerpeksag/astor
License:: 3-clause BSD
Build status:

astor is designed to allow easy manipulation of Python source via the AST.

There are some other similar libraries, but astor focuses on the following areas:

Round-trip an AST back to Python [1]:
- Modified AST doesn’t need linenumbers, ctx, etc. or otherwise be directly compileable for the round-trip to work.
- Easy to read generated code as, well, code
- Can round-trip two different source trees to compare for functional differences, using the astor.rtrip tool (for example, after PEP8 edits).
Dump pretty-printing of AST
- Harder to read than round-tripped code, but more accurate to figure out what is going on.
- Easier to read than dump from built-in AST module
Non-recursive treewalk
- Sometimes you want a recursive treewalk (and astor supports that, starting at any node on the tree), but sometimes you don’t need to do that. astor doesn’t require you to explicitly visit sub-nodes unless you want to:
- You can add code that executes before a node’s children are visited, and/or
- You can add code that executes after a node’s children are visited, and/or
- You can add code that executes and keeps the node’s children from being visited (and optionally visit them yourself via a recursive call)
- Write functions to access the tree based on object names and/or attribute names
- Enjoy easy access to parent node(s) for tree rewriting

[1]

The decompilation back to Python is based on code originally written by Armin Ronacher. Armin’s code was well-structured, but failed on some obscure corner cases of the Python language (and even more corner cases when the AST changed on different versions of Python), and its output arguably had cosmetic issues – for example, it produced parentheses even in some cases where they were not needed, to avoid having to reason about precedence.

Other derivatives of Armin’s code are floating around, and typically have fixes for a few corner cases that happened to be noticed by the maintainers, but most of them have not been tested as thoroughly as astor. One exception may be the version of codegen maintained at github by CensoredUsername. This has been tested to work properly on Python 2.7 using astor’s test suite, and, as it is a single source file, it may be easier to drop into some applications that do not require astor’s other features or Python 3.x compatibility.

Release files for astor 0.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for astor 0.8.1
File	Size	Uploaded
astor-0.8.1.tar.gz	35.1 kB	Dec 10, 2019	Details

Built distribution (wheel)

Table of built distributions (wheels) for astor 0.8.1
File	Interpreter	ABI	Platform	Reset
astor-0.8.1-py2.py3-none-any.whl 27.5 kB Dec 10, 2019	Python 3, Python 2	none	any	Details

Total release size: 62.6 kB

Release files / astor-0.8.1.tar.gz

Download URL	astor-0.8.1.tar.gz
Size	35.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`6a6effda93f4e1ce9f618779b2dd1d9d84f1e32812c23a29b3fff6fd7f63fa5e`
BLAKE2b-256 checksum How to use checksums	`5a2175b771132fee241dfe601d39ade629548a9626d1d39f333fde31bc46febe`
Upload date	Dec 10, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/2.7.14`

Release files / astor-0.8.1-py2.py3-none-any.whl

Download URL	astor-0.8.1-py2.py3-none-any.whl
Size	27.5 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`070a54e890cefb5b3739d19f30f5a5ec840ffc9c50ffa7d23cc9fc1a38ebbfc5`
BLAKE2b-256 checksum How to use checksums	`c38897eef84f48fa04fbd6750e62dcceafba6c63c81b7ac1420856c8dcc0a3f9`
Upload date	Dec 10, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/2.7.14`