
Pythonバイトコード(.pyc/.pyo)を逆コンパイルおよび逆アセンブルし、読みやすいソースコードに戻します。Python 2.0~3.15(CPython、PyPy、その他の実装)をサポートしています。Rustで書かれています。
英語 | 简体中文
Python 2.0 から 3.15 までの Python バイトコード(.pyc)を、読みやすいソースコードへ逆コンパイルおよび逆アセンブルします。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% 削減される--opcodes で上書き可能Homebrew(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 の両方をインストールします。代わりに名前でインストールするには、バケットを一度追加します:
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 に注記が出力されます。動作マトリクスは --cure の有無にかかわらず 754/754 で合格し、528 個のコーパスモジュールはすべて、それ自身のインタプリタ上で --cure を付けてコンパイルできます。このパスは意図的に文の形(if/else → 三項演算子)を書き換えるため、コーパスのバイトコード署名メトリクスは --cure の出力には意味を持ちません。動作マトリクスで評価してください。
pycdc --help、pycdc dis --help、pycdas --help はすべてのフラグを文書化しています。終了コード: 0 成功、1 ファイルの処理に失敗、2 使用法エラー。
Apple Silicon、526 個の実在する .pyc ファイル(約 9.5 MB、Python 2.6–3.14 標準ライブラリ):
| シナリオ | 時間 | ピーク RSS |
|---|---|---|
| バッチ、並列(デフォルト) | ≈0.05 秒 | ≈25 MB |
バッチ、直列(-j 1) | ≈0.34 秒 | ≈13 MB |
| 最大の単一ファイル(74 KB、起動時間を含む) | ≈5.5 ms | ≈4.4 MB |
| プロセス起動 | ≈2 ms | — |
tools/fetch_realworld.sh は 7 つのプロジェクトそれぞれから 最新リリースタグ時点で 1 つのディレクトリを 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 |
¹ 厳密判定: docstring を除去した AST が元のソースと等しいこと — 等価な正規化(三項演算子の代わりに if/else、アンパックの周囲の冗長な *()/**{}、キーワード引数の順序変更)は差分として数えられるため、エラー率ではなく形の忠実度の下限として扱ってください。受け入れ基準は解析/再コンパイルの列です。
プロジェクトごとに 1 つの pycdc プロセス: 直列でモジュールあたり約 0.87 ms、6.4 k モジュールのバッチ全体でピーク RSS は約 78 MB。6411 個のモジュールすべてが再コンパイルされます。最後のファミリー(ジェネレータ式の要素内にネストされた dict 内包表記、呼び出し引数を含む)はコミュニティの PR バッチによって解消されました。生データ: benchmarks/realworld.json、ハーネス: tools/bench_realworld.py。
3 つの独立したハーネスがあり、すべてローカルで実行可能です(pyenv/uv のインタプリタ 2.6–3.15 が必要):
| ハーネス | 証明する内容 | 現状 |
|---|---|---|
tools/verify_corpus.py | 622 個の標準ライブラリモジュール: 逆コンパイル → 同じ インタプリタで再コンパイル → バイトコード署名を比較、失敗時は正規化 AST 差分にフォールバック | 622/622 意味的に一致(499 件が署名完全一致、構文エラー 0、プレースホルダ 0) |
tools/run_behavior.py | 96 個の動作ケース × 14 個のインタプリタ: 元のコードと逆コンパイル後のコードを実行し、stdout と終了コードを比較 | 754/754 = 100%(2.6–3.15) |
tests/roundtrip.py | フィクスチャマトリクス: コンパイル → 逆コンパイル → 再コンパイル → 厳密なバイトコード比較 | 49/54 が厳密一致(例外フィクスチャは構造的に異なるが意味的に等価) |
3.15 の結果は CPython 3.15.0/3.15.1 を反映しており、インライン内包表記、呼び出し、インポートのエンコーディングが変更されています。そのオペコードテーブルは実行中のインタプリタから生成されます。すべての動作ケースが合格し、pandas+scikit-learn は 3.15 で 2091/2091 が再コンパイルされます。残る with 本体の return に関するエッジケースは docs/LIMITATIONS.md に記載されています。