
Декомпилирует и дизассемблирует байт-код Python (.pyc/.pyo) обратно в читаемый исходный код. Поддерживает Python 2.0 - 3.15 (CPython, PyPy и другие реализации). Написан на Rust.
Английский | 简体中文
Декомпилируйте и дизассемблируйте байт-код Python (.pyc) от Python 2.0 до 3.15 обратно в читаемый исходный код — написан на Rust, не требует Python во время выполнения, с опциональным внутрипроцессным проходом через упроститель cure.
pycdc program.pyc # decompile to stdout
pycdc dis program.pyc # disassemble (exception tables, line numbers, nested code)
--cure: прогоняет вывод через упроститель/форматтер cure в том же процессе — без внешнего бинарника, без Python — превращая if cond: return a / return b в return a if cond else b и сокращая ~10% строк--opcodesHomebrew (macOS и Linux):
brew install ejfkdev/tap/pycdc
Scoop (Windows):
scoop install https://raw.githubusercontent.com/ejfkdev/scoop-bucket/main/bucket/pycdc.json
Манифест автоматически выбирает x64 или arm64 и устанавливает как pycdc, так и pycdas. Чтобы установить по имени, один раз добавьте bucket:
scoop bucket add ejfkdev https://github.com/ejfkdev/scoop-bucket
scoop install pycdc
cargo, из crates.io:
cargo install pycdc
Готовые бинарные файлы: необработанные исполняемые файлы (без обёртки архива) на странице Releases — Linux / Windows x86_64 + arm64, macOS arm64 + x86_64; сборки для Linux и Windows сжаты UPX, для macOS поставляются без сжатия.
Из исходного кода:
cargo build --release # -> target/release/pycdc + pycdas
cargo install --path . # or install both binaries from a checkout
Каждый метод предоставляет как pycdc, так и 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 включается по желанию и носит чисто косметический характер: вывод pycdc уже проверен, поэтому поведение по умолчанию остаётся неизменным. С ним условные конструкции сворачиваются в тернарные выражения, кавычки нормализуются к одинарным, а форматирование перестраивается:
# default # --cure
def classify(v): def classify(v):
if v is True: return 1 if v is True else 0
return 1
return 0
Если входные данные не удаётся разобрать с помощью cure, или если они содержат
метаданные интроспекции компилятора (__annotate__, co_freevars,
__conditional_annotations__, __classdict__), где упрощение могло бы
изменить поведение во время выполнения, файл выводится без изменений, а примечание
направляется в stderr. Матрица поведения проходит 754/754 как с --cure,
так и без него, и все 528 модулей корпуса по-прежнему компилируются под своим
собственным интерпретатором с ним. Поскольку проход намеренно переписывает формы
инструкций (if/else → тернарный оператор), метрика байткод-сигнатур корпуса
не имеет смысла для вывода --cure; оценивайте его по матрице поведения.
pycdc --help, pycdc dis --help и pycdas --help документируют каждый
флаг. Коды выхода: 0 — успех, 1 — не удалось обработать файл, 2 — ошибка
использования.
Apple Silicon, 526 реальных файлов .pyc (~9,5 МБ, stdlib Python 2.6–3.14):
| Сценарий | Время | Пиковый RSS |
|---|---|---|
| Пакетный, параллельный (по умолчанию) | ≈0,05 с | ≈25 МБ |
Пакетный, последовательный (-j 1) | ≈0,34 с | ≈13 МБ |
| Крупнейший одиночный файл (74 КБ, включая запуск) | ≈5,5 мс | ≈4,4 МБ |
| Запуск процесса | ≈2 мс | — |
tools/fetch_realworld.sh выполняет sparse-checkout одной директории из каждого из
семи проектов на его последнем теге релиза, компилирует каждый .py в
.pyc (compileall -b) и размещает дерево в tests/realworld/
(игнорируется git — скрипт является способом воссоздать его):
| Проект (тег) | модули | последовательный -j 1 | параллельный (по умолчанию) | перекомпиляции | AST-идентичные¹ |
|---|---|---|---|---|---|
| yt-dlp (2026.08.19) | 1045 | 0,38 с | 0,08 с | 1045/1045 | 502/1045 |
| matplotlib (v3.11.2) | 253 | 0,28 с | 0,07 с | 253/253 | 60/253 |
| pandas (v3.0.5) | 1420 | 0,87 с | 0,16 с | 1420/1420 | 586/1420 |
| django (6.1.1) | 907 | 0,33 с | 0,12 с | 907/907 | 470/907 |
| sympy (1.14.0) | 1532 | 3,08 с | 1,62 с | 1532/1532 | 482/1532 |
| scikit-learn (1.9.1) | 671 | 0,42 с | 0,07 с | 671/671 | 216/671 |
| ansible (v2.21.4) | 583 | 0,24 с | 0,05 с | 583/583 | 186/583 |
| итого | 6411 | 5,60 с | 2,17 с | 6411/6411 (100 %) | 2502/6411 |
¹ строго: AST с удалёнными docstring, равный исходному источнику —
эквивалентные нормализации (if/else вместо тернарного оператора, избыточные
*()/**{} вокруг распаковки, переупорядоченные именованные аргументы) считаются
различиями, поэтому рассматривайте это как нижнюю границу точности формы, а не как
частоту ошибок. Столбец разбора/перекомпиляции — это критерий приёмки.