
Décompiler et désassembler le bytecode Python (.pyc/.pyo) pour le restaurer en code source lisible. Prend en charge Python 2.0 - 3.15 (CPython, PyPy et autres implémentations). Écrit en Rust.
Anglais | 简体中文
Décompilez et désassemblez le bytecode Python (.pyc) de Python 2.0 à 3.15 pour le reconstituer en code source lisible — écrit en Rust, sans nécessiter Python à l'exécution, avec une passe optionnelle en cours de processus via le simplificateur cure.
pycdc program.pyc # decompile to stdout
pycdc dis program.pyc # disassemble (exception tables, line numbers, nested code)
--cure : fait passer la sortie par le simplificateur/formateur cure en cours de processus — aucun binaire externe, aucun Python — transformant if cond: return a / return b en return a if cond else b et réduisant d'environ 10 % le nombre de lignes--opcodesHomebrew (macOS et Linux) :
brew install ejfkdev/tap/pycdc
Scoop (Windows) :
scoop install https://raw.githubusercontent.com/ejfkdev/scoop-bucket/main/bucket/pycdc.json
Le manifeste sélectionne automatiquement x64 ou arm64 et installe à la fois pycdc
et pycdas. Pour installer par nom à la place, ajoutez le bucket une fois :
scoop bucket add ejfkdev https://github.com/ejfkdev/scoop-bucket
scoop install pycdc
cargo, depuis crates.io :
cargo install pycdc
Binaires précompilés : exécutables bruts (sans archive) sur la page Releases — Linux / Windows x86_64 + arm64, macOS arm64 + x86_64 ; les builds Linux et Windows sont compressés avec UPX, macOS est livré non compressé.
Depuis les sources :
cargo build --release # -> target/release/pycdc + pycdas
cargo install --path . # or install both binaries from a checkout
Chaque méthode fournit à la fois pycdc et pycdas.
# single file -> stdout, a file, or a directory
pycdc program.pyc > program.py
pycdc program.pyc -o program.py
pycdc program.pyc -o ./outdir/
# stdin (pipelines): - reads the pyc from stdin
cat program.pyc | pycdc -
# batch: mirror a directory tree (parallel by default, -j N to control,
# -q suppresses the per-file src -> dst lines)
pycdc ./pyc-corpus -o ./src-out
pycdc ./pyc-corpus # -> ./pyc-corpus-decompiled/
pycdc a.pyc b.pyc # -> a.py, b.py next to the inputs
pycdc ./pyc-corpus -o ./src-out -q -j 8
# raw marshal (no pyc header) with an explicit version
pycdc -v 3.8 payload.marshal
# disassembly — same CLI surface (files, dirs, stdin, -o/-j/-q)
pycdc dis program.pyc
pycdc dis ./pyc-corpus -o ./dis-out # -> mirrored .dis files
# the standalone `pycdas` binary is kept as a compatibility alias
# with byte-identical output
pycdas program.pyc
# optional simplification/formatting pass (cure, linked in-process)
pycdc --cure program.pyc
--cure est optionnel et purement cosmétique : la sortie de pycdc est déjà
vérifiée, donc la valeur par défaut reste inchangée. Avec cette option, les conditionnelles se réduisent
en ternaires, les guillemets sont normalisés en guillemets simples et le formatage est
reformaté :
# default # --cure
def classify(v): def classify(v):
if v is True: return 1 if v is True else 0
return 1
return 0
Si l'entrée ne peut pas être analysée par cure, ou si elle contient des métadonnées d'introspection du compilateur (__annotate__, co_freevars, __conditional_annotations__, __classdict__) dont la simplification pourrait modifier le comportement à l'exécution, le fichier est émis inchangé et une note est envoyée sur stderr. La matrice de comportement passe 754/754 avec et sans --cure, et les 528 modules du corpus se compilent toujours sous leur propre interpréteur avec cette option. Comme la passe réécrit délibérément la forme des instructions (if/else → ternaire), la métrique de signature de bytecode du corpus n'est pas pertinente pour la sortie de --cure ; jugez-la à l'aune de la matrice de comportement.
pycdc --help, pycdc dis --help et pycdas --help documentent chaque option. Codes de sortie : 0 succès, 1 échec de traitement d'un fichier, 2 erreur d'utilisation.
Apple Silicon, 526 fichiers .pyc réels (~9,5 Mo, stdlib Python 2.6–3.14) :
| Scénario | Temps | RSS maximal |
|---|---|---|
| Lot, parallèle (par défaut) | ≈0,05 s | ≈25 Mo |
Lot, série (-j 1) | ≈0,34 s | ≈13 Mo |
| Plus gros fichier unique (74 Ko, démarrage inclus) | ≈5,5 ms | ≈4,4 Mo |
| Démarrage du processus | ≈2 ms | — |
tools/fetch_realworld.sh effectue un sparse-checkout d'un répertoire de chacun des sept projets à sa dernière balise de version, compile chaque .py en .pyc (compileall -b) et dépose l'arborescence dans tests/realworld/ (ignoré par git — le script est le moyen de la recréer) :
| Projet (balise) | modules | série -j 1 | parallèle (par défaut) | recompilations | AST identique¹ |
|---|---|---|---|---|---|
| yt-dlp (2026.08.19) | 1045 | 0,38 s | 0,08 s | 1045/1045 | 502/1045 |
| matplotlib (v3.11.2) | 253 | 0,28 s | 0,07 s | 253/253 | 60/253 |
| pandas (v3.0.5) | 1420 | 0,87 s | 0,16 s | 1420/1420 | 586/1420 |
| django (6.1.1) | 907 | 0,33 s | 0,12 s | 907/907 | 470/907 |
| sympy (1.14.0) | 1532 | 3,08 s | 1,62 s | 1532/1532 | 482/1532 |
| scikit-learn (1.9.1) | 671 | 0,42 s | 0,07 s | 671/671 | 216/671 |
| ansible (v2.21.4) | 583 | 0,24 s | 0,05 s | 583/583 | 186/583 |
| total | 6411 | 5,60 s | 2,17 s | 6411/6411 (100 %) | 2502/6411 |