experimental/sources/: astunparse-1.6.3 metadata and description

Homepage Simple index

An AST unparser for Python

classifiers
  • Development Status :: 5 - Production/Stable
  • Intended Audience :: Developers
  • License :: OSI Approved :: BSD License
  • Natural Language :: English
  • Programming Language :: Python :: 2
  • Programming Language :: Python :: 2.7
  • Programming Language :: Python :: 3
  • Programming Language :: Python :: 3.5
  • Programming Language :: Python :: 3.6
  • Programming Language :: Python :: 3.7
  • Programming Language :: Python :: 3.8
  • Topic :: Software Development :: Code Generators
keywords astunparse
license BSD
maintainer Simon Percivall
maintainer_email percivall@gmail.com
platform
  • UNKNOWN
File Tox results History
astunparse-1.6.3.tar.gz
Size
18 KB
Type
Source
https://badge.fury.io/py/astunparse.png https://travis-ci.org/simonpercivall/astunparse.png?branch=master https://readthedocs.org/projects/astunparse/badge/

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.

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.