
Descompila y desensambla el bytecode de Python (.pyc/.pyo) de vuelta a código fuente legible. Compatible con Python 2.0 - 3.15 (CPython, PyPy y otras implementaciones). Escrito en Rust.
Inglés | 简体中文
Descompila y desensambla bytecode de Python (.pyc) desde Python 2.0 hasta 3.15 de vuelta a código fuente legible — escrito en Rust, sin necesidad de Python en tiempo de ejecución, con un paso opcional en proceso a través del simplificador cure.
pycdc program.pyc # decompile to stdout
pycdc dis program.pyc # disassemble (exception tables, line numbers, nested code)
--cure opcional: pliega la salida a través del simplificador/formateador cure en proceso — sin binario externo, sin Python — convirtiendo if cond: return a / return b en return a if cond else b y recortando ~10% de las líneas--opcodesHomebrew (macOS y Linux):
brew install ejfkdev/tap/pycdc
Scoop (Windows):
scoop install https://raw.githubusercontent.com/ejfkdev/scoop-bucket/main/bucket/pycdc.json
El manifiesto selecciona x64 o arm64 automáticamente e instala tanto pycdc
como pycdas. Para instalar por nombre en su lugar, añade el bucket una vez:
scoop bucket add ejfkdev https://github.com/ejfkdev/scoop-bucket
scoop install pycdc
cargo, desde crates.io:
cargo install pycdc
Binarios precompilados: ejecutables sin procesar (sin envoltorio de archivo) en la página de Releases — Linux / Windows x86_64 + arm64, macOS arm64 + x86_64; las compilaciones de Linux y Windows están comprimidas con UPX, macOS se distribuye sin comprimir.
Desde el código fuente:
cargo build --release # -> target/release/pycdc + pycdas
cargo install --path . # or install both binaries from a checkout
Cada método proporciona tanto pycdc como 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 es opcional y puramente cosmético: la salida de pycdc ya está
verificada, por lo que el comportamiento predeterminado permanece intacto. Con él, los condicionales se colapsan
en ternarios, las comillas se normalizan a comillas simples y el formato se reajusta:
# 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 cure no puede analizar la entrada, o si esta contiene metadatos de introspección del compilador (__annotate__, co_freevars, __conditional_annotations__, __classdict__) donde la simplificación podría cambiar el comportamiento en tiempo de ejecución, el archivo se emite sin cambios y se envía una nota a stderr. La matriz de comportamiento pasa 754/754 tanto con como sin --cure, y los 528 módulos del corpus siguen compilando bajo su propio intérprete con él. Dado que la pasada reescribe deliberadamente las formas de las sentencias (if/else → ternario), la métrica de firma de bytecode del corpus no es significativa para la salida de --cure; evalúela mediante la matriz de comportamiento.
pycdc --help, pycdc dis --help y pycdas --help documentan cada opción. Códigos de salida: 0 éxito, 1 un archivo no se pudo procesar, 2 error de uso.
Apple Silicon, 526 archivos .pyc reales (~9.5 MB, stdlib de Python 2.6–3.14):
| Escenario | Tiempo | RSS máximo |
|---|---|---|
| Lote, paralelo (predeterminado) | ≈0.05 s | ≈25 MB |
Lote, serial (-j 1) | ≈0.34 s | ≈13 MB |
| Archivo único más grande (74 KB, incl. arranque) | ≈5.5 ms | ≈4.4 MB |
| Arranque del proceso | ≈2 ms | — |
tools/fetch_realworld.sh hace un sparse-checkout de un directorio de cada uno de los siete proyectos en su etiqueta de última versión, compila cada .py a .pyc (compileall -b) y deja el árbol en tests/realworld/ (ignorado por git — el script es la forma de recrearlo):
| Proyecto (etiqueta) | módulos | serial -j 1 | paralelo (predeterminado) | recompilaciones | AST idéntico¹ |
|---|---|---|---|---|---|
| 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 |
¹ estricto: AST sin docstrings igual al código fuente original — las normalizaciones equivalentes (un if/else en lugar de un ternario, un *()/**{} redundante alrededor de un desempaquetado, argumentos de palabra clave reordenados) cuentan como diferencias, así que trátelo como un límite inferior de fidelidad de forma más que como una tasa de error. La columna de análisis/recompilación es el criterio de aceptación.