Skip to content
KitploitKITPLOIT
도구블로그
Log in
제출
도구블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
pycdc — Python 바이트코드(.pyc/.pyo)를 디컴파일 및 디스어셈블하여 읽을 수 있는 소스로 복원합니다. Python 2.0 - 3.15(CPython, PyPy 및 기타 구현체)를 지원합니다. Rust로 작성되었습니다. | Kitploit
도구/GitHubGitHub/ejfkdev/pycdc
Static AnalysisCode AnalysisReverse EngineeringDebuggersMalware AnalysisUtilities & FrameworksBinary Analysis
GitHubejfkdev/pycdc

pycdc

Python 바이트코드(.pyc/.pyo)를 디컴파일 및 디스어셈블하여 읽을 수 있는 소스로 복원합니다. Python 2.0 - 3.15(CPython, PyPy 및 기타 구현체)를 지원합니다. Rust로 작성되었습니다.

저장소 보기
18310317일 전아직 검토되지 않음
공유

pycdc-rs

영어 | 简体中文

License: MIT Python Corpus Behavior Built with ZCode

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)

주요 특징

  • 14개 인터프리터(2.6–3.15)에 걸친 622개 모듈의 실제 stdlib 코퍼스에서 100% 의미적 동등성; 80.2%는 시그니처까지 정확히 일치
  • 동작 매트릭스 754/754 = 100%: 새로운 3.15 바이트코드 인코딩을 포함하여 모든 케이스가 2.6–3.15에서 통과
  • 최신 구문: PEP 695/696 타입 매개변수, PEP 750 t-strings, PEP 649 지연 어노테이션, match/case, walrus, async, f-strings
  • 선택적 --cure: 출력을 프로세스 내에서 cure 단순화/포매터를 통해 처리 — 외부 바이너리 없음, Python 없음 — if cond: return a / return b를 return a if cond else b로 변환하고 약 10%의 줄을 줄임
  • 버전 차이는 순수한 데이터: 릴리스마다 하나의 내장 opcode 테이블이 있으며 --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—

실제 코퍼스 (대형 프로젝트 7개, 최신 릴리스 태그)

tools/fetch_realworld.sh는 7개 프로젝트 각각에서 최신 릴리스 태그의 디렉터리 하나를 sparse-checkout하고, 모든 .py를 .pyc로 컴파일하며(compileall -b), 트리를 tests/realworld/에 배치합니다(git-ignored — 이 스크립트가 재생성 방법입니다):

프로젝트 (태그)모듈 수직렬 -j 1병렬 (기본)재컴파일AST 동일¹
yt-dlp (2026.08.19)10450.38 s0.08 s1045/1045502/1045
matplotlib (v3.11.2)2530.28 s0.07 s253/25360/253
pandas (v3.0.5)14200.87 s0.16 s1420/1420586/1420
django (6.1.1)9070.33 s0.12 s907/907470/907
sympy (1.14.0)15323.08 s1.62 s1532/1532482/1532
scikit-learn (1.9.1)6710.42 s0.07 s671/671216/671
ansible (v2.21.4)5830.24 s0.05 s583/583186/583
합계64115.60 s2.17 s6411/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에 문서화되어 있습니다.

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →