C++ python bytecode disassembler and decompiler
  • C++ 84.5%
  • Python 14.9%
  • CMake 0.5%
Find a file
2017-07-05 16:10:09 -07:00
bytes Initial support for Python 3.6 disassembly 2016-06-22 22:06:09 -07:00
tests Add python 2.5 reference sources 2016-09-08 09:59:10 -07:00
.gitignore Switch build system to CMake 2014-06-10 19:20:56 -07:00
ASTNode.cpp Support @ operator 2015-10-01 17:03:41 -07:00
ASTNode.h Help convince clang that 'this' can be NULL in some cases. Closes #65 2015-10-02 23:00:07 -07:00
ASTree.cpp Handle NOP instruction in decompyle (fixes #96) 2016-10-24 09:44:06 -07:00
ASTree.h Fixed imports, and restructured ifs to be "code blocks" 2010-09-07 21:32:34 -07:00
bytecode.cpp Update bytecode for Python 3.6 beta3, and use a common file for opcode names 2016-11-08 16:00:56 -08:00
bytecode.h Update bytecode for Python 3.6 beta3, and use a common file for opcode names 2016-11-08 16:00:56 -08:00
bytecode_ops.inl Update bytecode for Python 3.6 beta3, and use a common file for opcode names 2016-11-08 16:00:56 -08:00
CMakeLists.txt Add more advanced round-trip test target that runs decompiled output back 2016-08-30 20:18:29 -07:00
data.cpp Fixes for large operands (> 0x7fff). Closes #34 2013-08-06 22:16:28 -07:00
data.h Allow for output file override 2011-10-23 19:04:06 -07:00
FastStack.h Slightly more consistent formatting 2011-09-18 23:55:27 -07:00
LICENSE Added GPL v3 license file 2009-07-25 00:43:46 +00:00
pyc_code.cpp Make version comparisons human readable 2012-05-26 14:10:12 -07:00
pyc_code.h Fix display of cell vars 2016-09-07 18:22:49 -07:00
pyc_module.cpp Add MAGIC_NUMBER for Python 3.5.3 2017-04-11 09:55:40 +05:30
pyc_module.h Minor typing/aliasing cleanup 2017-07-05 16:10:09 -07:00
pyc_numeric.cpp Minor typing/aliasing cleanup 2017-07-05 16:10:09 -07:00
pyc_numeric.h Minor typing/aliasing cleanup 2017-07-05 16:10:09 -07:00
pyc_object.cpp Minor typing/aliasing cleanup 2017-07-05 16:10:09 -07:00
pyc_object.h Help convince clang that 'this' can be NULL in some cases. Closes #65 2015-10-02 23:00:07 -07:00
pyc_sequence.cpp Support new marshal types from Python 3.4 2014-01-21 00:42:37 -08:00
pyc_sequence.h Use less conflicting filenames 2011-10-23 17:48:10 -07:00
pyc_string.cpp Fix formatting of char literals \x00-\x0F. 2016-08-31 08:28:46 -07:00
pyc_string.h Minor style cleanup 2014-06-10 18:28:28 -07:00
pycdas.cpp Display KW only arg count in pycdas output 2016-09-03 11:05:03 -07:00
pycdc.cpp Fix a couple of string output issues 2011-10-23 19:37:06 -07:00
pycdc_rt_test.sh Use .src.py extension instead of .src for pycdc test output 2016-08-31 16:13:18 -07:00
pycdc_test.sh Use .src.py extension instead of .src for pycdc test output 2016-08-31 16:13:18 -07:00
PythonBytecode.txt Add MAGIC_NUMBER for Python 3.5.3 2017-04-11 09:55:40 +05:30
README.markdown Fix #51 by adding more precise build instructions 2014-12-03 18:07:27 -08:00

Decompyle++

A Python Byte-code Disassembler/Decompiler

Decompyle++ aims to translate compiled Python byte-code back into valid and human-readable Python source code. While other projects have achieved this with varied success, Decompyle++ is unique in that it seeks to support byte-code from any version of Python.

Decompyle++ includes both a byte-code disassembler (pycdas) and a decompiler (pycdc).

As the name implies, Decompyle++ is written in C++. If you wish to contribute, please fork us on github at https://github.com/zrax/pycdc

Building Decompyle++

  • Generate a project or makefile with CMake (See CMake's documentation for details)
  • Build the generated project or makefile
    • For projects (e.g. MSVC), open the generated project file and build it
    • For makefiles, just run make
    • To run tests (on *nix or MSYS), run make test

Usage

To run pycdas, the PYC Disassembler: ./pycdas [PATH TO PYC FILE] The byte-code disassembly is printed to stdout.

To run pycdc, the PYC Decompiler: ./pycdc [PATH TO PYC FILE] The decompiled Python source is printed to stdout. Any errors are printed to stderr.

Authors, Licence, Credits

Decompyle++ is the work of Michael Hansen and Darryl Pogue.

Additional contributions from:

  • charlietang98
  • Kunal Parmar
  • Olivier Iffrig
  • Zlodiy

It is released under the terms of the GNU General Public License, version 3; See LICENSE file for details.