Metadata-Version: 2.1
Name: meta
Version: 1.0.2
Summary: Byte-code and ast programming tools
Home-page: http://srossross.github.com/Meta
Author: Sean Ross-Ross, Enthought Inc.
Author-email: srossross@enthought.com
Maintainer: Sean Ross-Ross
Maintainer-email: enthought-dev@enthought.com
License: BSD
Platform: Windows
Platform: Linux
Platform: Mac OS-X
Platform: Unix
Platform: Solaris
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries

Meta
====

A Pure Python module containing a framework to manipulate and analyze
python abstract syntax trees and bytecode.

Example
========

This shows how to take python source to a code object and back again from within python:

.. code-block:: python

    import meta, ast
    source = '''
    a = 1
    b = 2
    c = (a ** b)
    '''

    mod = ast.parse(source, '<nofile>', 'exec')
    code = compile(mod, '<nofile>', 'exec')

    mod2 = meta.decompile(code)
    source2 = meta.dump_python_source(mod2)

    assert source == source2

This shows the depyc script. The script compiles itself, and then the compiled script extracts itself:

.. code-block:: bash

    DEPYC_FILE=`python -c"import meta.scripts.depyc; print meta.scripts.depyc.__file__"`
    depyc $DEPYC_FILE --pyc > depycX.pyc
    python -m depycX depycX.pyc --python > depycX.py
    echo depycX.py


Notes
======

* Meta is python3 compliant (mostly)

Bugs
=====

* The decompliler does not yet support complex list/set/dict - comprehensions

Testing
=======

.. code-block:: bash

    python -m unittest discover meta

    test


Versioning
==========
From the version 1.0.0, Meta follows `Semantic Versioning <http://semver.org/spec/v1.0.0.html>`_.
The version X.Y.Z indicates:

* X is the major version (backward-incompatible),
* Y is the minor version (backward-compatible), and
* Z is the patch version (backward-compatible bug fix).

Prior to version 1.0.0, custom versioning scheme was used.

