
فكّك وفكّ تجميع بايت كود Python (.pyc/.pyo) لإعادته إلى شيفرة مصدرية قابلة للقراءة. يدعم Python 2.0 - 3.15 (CPython وPyPy وتطبيقات أخرى). مكتوب بلغة Rust.
الإنجليزية | 简体中文
فكّك وترجم بايت كود بايثون (.pyc) من بايثون 2.0 حتى 3.15 إلى شيفرة مصدرية قابلة للقراءة — مكتوب بلغة Rust، دون الحاجة إلى بايثون وقت التشغيل، مع تمريرة اختيارية داخل العملية عبر مبسّط 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 ميغابايت، مكتبة 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 بدلًا من ثلاثي، *()/**{} زائدة
حول فك التغليف، إعادة ترتيب الوسائط المسمّاة) اختلافات، لذا تعامل معها
كحدٍّ أدنى لدقة الشكل لا كمعدل خطأ. عمود التحليل/إعادة الترجمة هو معيار
القبول.
عملية pycdc واحدة لكل مشروع: ~0.87 مللي ث لكل وحدة تسلسليًا، ذروة RSS
≈78 ميغابايت لكامل الدفعة البالغة 6.4 ألف وحدة. تُعاد ترجمة جميع الوحدات الـ 6411؛
أُغلقت العائلة الأخيرة (فهم قاموس متداخل داخل عنصر تعبير مُولِّد،
بما في ذلك وسائط الاستدعاء) بواسطة دفعة طلبات السحب المجتمعية. البيانات الخام: benchmarks/realworld.json،
أداة الاختبار: tools/bench_realworld.py.
ثلاث أدوات اختبار مستقلة، جميعها قابلة للتشغيل محليًا (تحتاج مُفسِّرات pyenv/uv 2.6–3.15):