https://github.com/Mysterie/uncompyle2
uncompyle2
https://github.com/Mysterie/uncompyle2
Last synced: 6 months ago
JSON representation
uncompyle2
- Host: GitHub
- URL: https://github.com/Mysterie/uncompyle2
- Owner: Mysterie
- Created: 2012-06-05T08:28:26.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2015-06-25T10:37:09.000Z (over 10 years ago)
- Last Synced: 2024-08-04T01:28:03.013Z (over 1 year ago)
- Language: Python
- Size: 765 KB
- Stars: 641
- Watchers: 51
- Forks: 148
- Open Issues: 11
-
Metadata Files:
- Readme: README.rst
Awesome Lists containing this project
README
uncompyle2
==========
A Python 2.5, 2.6, 2.7 byte-code decompiler, written in Python 2.7
Introduction
------------
'uncompyle2' converts Python byte-code back into equivalent Python
source code. It accepts byte-code from Python version 2.5 to 2.7.
Additionally, it will only run on Python 2.7.
The generated source is very readable: docstrings, lists, tuples and
hashes get pretty-printed.
'uncompyle2' is based on John Aycock's generic small languages compiler
'spark' (http://www.csr.uvic.ca/~aycock/python/) and his prior work on
a tool called 'decompyle'. This tool has been vastly improved by
Hartmut Goebel `http://www.crazy-compilers.com/`_
# Additional note (3 July 2004, Ben Burton):
This software is no longer available from the original website. It has
now become a commercial decompilation service, with no software
available for download.
Any developers seeking to make alterations or enhancements to this code
should therefore consider these debian packages an appropriate starting
point.
# Additional note (5 June 2012):
The decompilation of python bytecode 2.5 & 2.6 is based on the work of
Eloi Vanderbeken. bytecode is translated to a pseudo 2.7 python bytecode
and then decompiled.
Features
--------
- decompiles Python byte-code into equivalent Python source
- decompiles byte-code from Python version 2.5, 2.6, 2.7
- pretty-prints docstrings, hashes, lists and tuples
- reads directly from .pyc/.pyo files, bulk-decompile whole directories
- output may be written to file, a directory or to stdout
- option for including byte-code disassembly into generated source
For a list of changes please refer to the 'CHANGES' file.
Requirements
------------
uncompyle2 requires Python 2.7
Installation
------------
You may either create a RPM and install this, or install directly from
the source distribution.
Creating RPMS:
python setup.py bdist_rpm
### Installation from the source distribution:
python setup.py install
To install to a user's home-dir:
python setup.py install --home=
To install to another prefix (eg. /usr/local)
python setup.py install --prefix=/usr/local
For more information on 'Installing Python Modules' please refer to
http://www.python.org/doc/current/inst/inst.html
Usage
-----
./scripts/uncompyle2 -h prints usage
./test_pythonlib.py test files and python library
Known Bugs/Restrictions
-----------------------
No support for python 3.2
It currently reconstructs most of Python code but probably needs to be tested more thoroughly. All feedback welcome