Byte-code and ast programming tools


License
BSD-3-Clause
Install
pip install meta==1.0.2

Documentation

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:

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:

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

python -m unittest discover meta

test

Versioning

From the version 1.0.0, Meta follows Semantic Versioning. 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.