
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개의 코퍼스 모듈 모두 해당 인터프리터에서 여전히 컴파일됩니다. 이 패스는 의도적으로 문장 형태(if/else → 삼항 연산자)를 재작성하므로, 코퍼스의 바이트코드 시그니처 지표는 --cure 출력에 대해 의미가 없습니다. 동작 매트릭스로 판단하십시오.
pycdc --help, pycdc dis --help, pycdas --help는 모든 플래그를 문서화합니다. 종료 코드: 0 성공, 1 파일 처리 실패, 2 사용법 오류.
Apple Silicon, 실제 .pyc 파일 526개(~9.5 MB, Python 2.6–3.14 표준 라이브러리):
| 시나리오 | 시간 | 최대 RSS |
|---|---|---|
| 배치, 병렬 (기본) | ≈0.05 s | ≈25 MB |
배치, 직렬 (-j 1) | ≈0.34 s | ≈13 MB |
| 최대 단일 파일 (74 KB, 시작 시간 포함) | ≈5.5 ms | ≈4.4 MB |
| 프로세스 시작 | ≈2 ms | — |
tools/fetch_realworld.sh는 7개 프로젝트 각각에서 최신 릴리스 태그의 디렉터리 하나를 sparse-checkout하고, 모든 .py를 .pyc로 컴파일하며(compileall -b), 트리를 tests/realworld/에 배치합니다(git-ignored — 이 스크립트가 재생성 방법입니다):
| 프로젝트 (태그) | 모듈 수 | 직렬 -j 1 | 병렬 (기본) | 재컴파일 | AST 동일¹ |
|---|---|---|---|---|---|
| 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 |
| 합계 | 6411 | 5.60 s | 2.17 s | 6411/6411 (100 %) | 2502/6411 |
¹ 엄격 기준: docstring을 제거한 AST가 원본 소스와 동일 — 동등한 정규화(삼항 연산자 대신 if/else, 언팩 주변의 중복 *()/**{}, 재정렬된 키워드 인자)는 차이로 간주되므로, 오류율이 아니라 형태 충실도의 하한으로 취급하십시오. 파싱/재컴파일 열이 합격 기준입니다.
프로젝트당 pycdc 프로세스 하나: 직렬 기준 모듈당 ~0.87 ms, 6.4 k 모듈 전체 배치의 최대 RSS ≈78 MB. 6411개 모듈 모두 재컴파일됩니다; 마지막 계열(제너레이터 표현식 요소 내부에 중첩된 dict 컴프리헨션, 호출 인자 포함)은 커뮤니티 PR 배치로 해결되었습니다. 원시 데이터: benchmarks/realworld.json, 하네스: tools/bench_realworld.py.
세 개의 독립 하네스, 모두 로컬에서 실행 가능(pyenv/uv 인터프리터 2.6–3.15 필요):
| 하네스 | 입증 내용 | 현재 |
|---|---|---|
tools/verify_corpus.py | 표준 라이브러리 모듈 622개: 디컴파일 → 동일한 인터프리터로 재컴파일 → 바이트코드 시그니처 비교, 실패 시 정규화된 AST diff로 대체 | 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을 반영하며, 해당 opcode 테이블은 실행 중인 인터프리터에서 생성됩니다. 모든 동작 케이스가 통과하고 pandas+scikit-learn이 3.15에서 2091/2091 재컴파일되며, 남은 with-본문-반환 엣지 케이스는 docs/LIMITATIONS.md에 문서화되어 있습니다.