Unparser for Python 3 abstract syntax trees (ASTs) with type comments.
The typed-astunparse is to typed-ast as astunparse is to ast. In short: unparsing of Python 3 abstract syntax trees (ASTs) with type comments.
Why this module was created
The built-in ast module can parse Python source code into AST but it can’t generate source code from the AST. The astunparse module (using a refactored version of an obscure script found in official Python repository) provides code generation capability for native Python AST.
However, both ast and astunparse modules completely ignore type comments introduced in
PEP 484. They treat them like all other comments, so when you parse the code using
compile(), your type comments will be lost. There is no place for them in the AST, so
obviously they also cannot be unparsed.
The typed-ast module provides an updated AST including type comments defined in PEP 484 and a parser for Python code that contains such comments.
Unfortunately, typed-ast doesn’t provide any means to go from AST back to source code with type comments. This is why module typed-astunparse (i.e. this one) was created: to provide unparser for AST defined in typed-ast.
Usage
Example of roundtrip from code through AST to code:
import typed_ast.ast3
import typed_astunparse
code = 'my_string = None # type: str'
roundtrip = typed_astunparse.unparse(typed_ast.ast3.parse(code))
print(roundtrip)This will print:
my_string = None # type: strfor more examples see examples.ipynb notebook.
Installation
For simplest installation use pip:
pip3 install typed-astunparseYou can also build your own version:
git clone https://github.com/mbdevpl/typed-astunparse
cd typed-astunparse
pip3 install -U test_requirements.txt
python3 -m unittest # make sure the tests pass
python3 setup.py bdist_wheel
pip3 install dist/*.whlRequirements
Python version 3.5 or later.
Python libraries as specified in requirements.txt.
Building and running tests additionally requires packages listed in test_requirements.txt.
Tested on Linux, OS X and Windows.
Links
Extensions of this module
If you’re extending typed-astunparse and you’d like to share why, feel free to submit a pull request introducing your project.
horast: human-oriented ast
Built upon both typed-ast and typed-astunparse providing parsing and unparsing of arbitrary comments in addition to type comments.
Who’s using this module and why
If you’re using typed-astunparse in your work and you’d like to share why, feel free to submit a pull request introducing your project.
static-typing: using typed-astunparse directly to provide AST unparsing function
References
ast:
astunparse:
https://pypi.org/project/astunparse
PEP 483 - The Theory of Type Hints:
PEP 484 - Type Hints:
PEP 3107 - Function Annotations:
PEP 526 - Syntax for Variable Annotations:
typed-ast:
1 maintainer
Metadata
1 maintainer
Release files for typed-astunparse 2.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| typed-astunparse-2.1.4.tar.gz | 23.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| typed_astunparse-2.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.2 kB
Release files / typed-astunparse-2.1.4.tar.gz
| Download URL | typed-astunparse-2.1.4.tar.gz |
|---|---|
| Size | 23.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8926f5280d346243b64090e7bf28911f004c5c80d8f46fd825a6e471454d19b7
|
|
BLAKE2b-256 checksum How to use checksums |
25de90815e11dfbe6741ea4efc497dbef8a1dd308b40b407094304082510b650
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3
|
Release files / typed_astunparse-2.1.4-py3-none-any.whl
| Download URL | typed_astunparse-2.1.4-py3-none-any.whl |
|---|---|
| Size | 14.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ee80ad573b4b20ebd541ecdf0bc7592d669f04e50a0961f7888bd9bcbc220080
|
|
BLAKE2b-256 checksum How to use checksums |
4fa0925c6b3475e0b146e19add88637a91c78fc41d0931118c8a92ea346c7990
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3
|
