https://github.com/zrax/pycdc

C++ python bytecode disassembler and decompiler
https://github.com/zrax/pycdc

cxx decompiler disassembler hacktoberfest python

Last synced: 2 months ago
JSON representation

C++ python bytecode disassembler and decompiler

• Host: GitHub
• URL: https://github.com/zrax/pycdc
• Owner: zrax
• License: gpl-3.0
• Created: 2011-09-18T04:16:33.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2024-03-12T22:56:16.000Z (3 months ago)
• Last Synced: 2024-03-12T23:49:42.747Z (3 months ago)
• Topics: cxx, decompiler, disassembler, hacktoberfest, python
• Language: C++
• Homepage:
• Size: 774 KB
• Stars: 2,592
• Watchers: 90
• Forks: 533
• Open Issues: 158
• Metadata Files:
  • Readme: README.markdown
  • License: LICENSE

Lists

• awesome-csirt - Decompyle++
• awesome-reverse-engineering - **671**星
• awesome-reverse-engineering - **671**星
• awesome-stars - zrax/pycdc - C++ python bytecode disassembler and decompiler (C++)
• awesome-stars - zrax/pycdc - C++ python bytecode disassembler and decompiler (C++)
• awesome-csirt - Decompyle++
• awesome-reverse-engineering - **671**星
• awesome-android-cpp - zrax/pycdc - C++ python bytecode disassembler and decompiler (TODO scan for Android support in followings)
• awesome-stars - pycdc
• awesome-python-re - pycdc - A disassembler and decompiler written in C++ aiming to support all Python versions. This decompiler is known to be unstable. (Decompilers)
• my-awesome-stars - zrax/pycdc - C++ python bytecode disassembler and decompiler (C++)
• awesome-stars - zrax/pycdc - `★2961` C++ python bytecode disassembler and decompiler (C++)

README

        
# 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](http://www.cmake.org) (See CMake's documentation for details)

  * The following options can be passed to CMake to control debug features:

    | Option | Description |

    | --- | --- |

    | `-DCMAKE_BUILD_TYPE=Debug` | Produce debugging symbols |

    | `-DENABLE_BLOCK_DEBUG=ON` | Enable block debugging output |

    | `-DENABLE_STACK_DEBUG=ON` | Enable stack debugging output |

* 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`

## 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 ` 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.