- C++ 84.5%
- Python 14.9%
- CMake 0.5%
9c5ea2f2bc
Python 3.11 compiles 'while cond:' with a bottom test: an entry guard (eval cond; POP_JUMP_FORWARD_IF_FALSE end) before the body, and a back-edge (eval cond; POP_JUMP_BACKWARD_IF_TRUE loop_start) at the end. pycdc rendered both halves as separate 'if' blocks, so EVERY while loop came out as 'if cond: ... if not cond: pass' and never looped. - New ScanWhileLoops pre-pass pairs each conditional backward jump with the forward guard immediately preceding its target (guard skipping to the instruction after the back-edge) to identify genuine while loops. - At the guard, open a BLK_WHILE with the condition instead of an if. - At the back-edge, discard the duplicated condition and close the loop, but only when a BLK_WHILE is actually open (guard against a misidentified back-edge collapsing the block stack and crashing). Fixes while loops across all files (including nested loops and continue). decompilation target: 237/239 files, corpus 41/95 (+1: signature; 0 regressions). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> |
||
|---|---|---|
| .github/workflows | ||
| bytes | ||
| CMakeFiles | ||
| scripts | ||
| tests | ||
| .gitignore | ||
| ASTNode.cpp | ||
| ASTNode.h | ||
| ASTree.cpp | ||
| ASTree.h | ||
| bytecode.cpp | ||
| bytecode.h | ||
| bytecode_ops.inl | ||
| cmake_install.cmake | ||
| CMakeCache.txt | ||
| CMakeLists.txt | ||
| data.cpp | ||
| data.h | ||
| FastStack.h | ||
| libpycxx.a | ||
| LICENSE | ||
| Makefile | ||
| pyc_code.cpp | ||
| pyc_code.h | ||
| pyc_module.cpp | ||
| pyc_module.h | ||
| pyc_numeric.cpp | ||
| pyc_numeric.h | ||
| pyc_object.cpp | ||
| pyc_object.h | ||
| pyc_sequence.cpp | ||
| pyc_sequence.h | ||
| pyc_string.cpp | ||
| pyc_string.h | ||
| pycdas | ||
| pycdas.cpp | ||
| pycdc | ||
| pycdc.cpp | ||
| README.markdown | ||
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)
- The following options can be passed to CMake to control debug features:
Option Description -DCMAKE_BUILD_TYPE=DebugProduce debugging symbols -DENABLE_BLOCK_DEBUG=ONEnable block debugging output -DENABLE_STACK_DEBUG=ONEnable stack debugging output
- The following options can be passed to CMake to control debug features:
-
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 check JOBS=4(optionalFILTER=xxxxto run only certain tests)
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.
Marshalled code objects:
Both tools support Python marshalled code objects, as output from marshal.dumps(compile(...)).
To use this feature, specify -c -v <version> on the command line - the version must be specified as the objects themselves do not contain version metadata.
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.