Byte-code and ast programming tools
Project description
Meta
====
.. image:: https://secure.travis-ci.org/srossross/Meta.png?branch=develop
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.
====
.. image:: https://secure.travis-ci.org/srossross/Meta.png?branch=develop
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
meta-1.0.0.tar.gz
(49.6 kB
view hashes)