Metadata-Version: 1.1
Name: astunparse
Version: 1.2.0
Summary: An AST unparser for Python
Home-page: https://github.com/simonpercivall/astunparse
Author: Simon Percivall
Author-email: percivall@gmail.com
License: BSD
Description: ============
        AST Unparser
        ============
        
        .. image:: https://badge.fury.io/py/astunparse.png
            :target: http://badge.fury.io/py/astunparse
        
        .. image:: https://travis-ci.org/simonpercivall/astunparse.png?branch=master
            :target: https://travis-ci.org/simonpercivall/astunparse
        
        .. image:: https://pypip.in/d/astunparse/badge.png
            :target: https://crate.io/packages/astunparse?version=latest
        
        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.4. It
        is authored by the Python core developers; I have simply merged the Python 2.7
        and the Python 3.4 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.
        
        Similar projects include:
        
            * codegen_
            * astor_
            * astmonkey_
            * astprint_
        
        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.
        
        * Documentation: http://astunparse.rtfd.org.
        
        Features
        --------
        
        * unparses Python AST.
        * pretty-prints AST.
        
        
        .. _codegen: https://github.com/andreif/codegen
        .. _astor: https://github.com/berkerpeksag/astor
        .. _astmonkey: https://github.com/konradhalas/astmonkey
        .. _astprint: https://github.com/Manticore/astprint
        
        
        =========
        Changelog
        =========
        
        Here's the recent changes to AST Unparser.
        
        .. changelog::
            :version: 1.2.0
            :released: 2014-04-03
        
            .. change::
                :tags: general
        
                Now compatible with Python 2.6 through Python 3.4.
        
            .. change::
                :tags: general
        
                A new function :func:`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.
        
        
        .. changelog::
            :version: 1.1.0
            :released: 2014-04-01
        
            .. change::
                :tags: general
        
                :func:`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.
        
        
Keywords: astunparse
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Code Generators
