الكود المصدري لكتاب "Violent Python" من تأليف TJ O'Connor. تم تحويل الكود بالكامل إلى Python 3، وإعادة تنسيقه ليتوافق مع معايير PEP8، وإعادة هيكلته لإزالة مشكلات التبعيات المتعلقة بتطبيق المكتبات المهجورة.
الشيفرة المصدرية من كتاب Violent Python: A Cookbook for Hackers, Forensic Analysts, Penetration Testers and Security Engineers للمؤلف TJ O'Connor (Syngress, 2012)، محوّلة من Python 2 إلى Python 3 ومُعاد هيكلتها لتعمل على المفسّرات والمكتبات الحالية.
تبقى السكربتات قريبة من القوائم المطبوعة حتى يمكن قراءتها جنبًا إلى جنب مع الكتاب. كل تغيير أُجري أثناء التحويل موثّق في docs/CONVERSION_NOTES.md.
[!NOTE] يوجد تحويل مرافق لكتاب Black Hat Python للمؤلف Justin Seitz على EONRaider/blackhat-python3.
Python 3.11 أو أحدث. اختر أحد الإعدادات التالية.
يقوم uv بتثبيت إصدار
Python المناسب إذا لم يكن لديك، ويعيد إنتاج إصدارات الاعتماديات الدقيقة
المختبرة في CI من uv.lock.
git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
uv sync # every chapter
uv run python chapter04/geo_ip.py -h
كل فصل هو مجموعة تبعيات منفصلة، لذا يمكنك تثبيت ما تقرأه فقط:
uv sync --only-group ch04 # just chapter 4
uv sync --group ch05-bluetooth # add the opt-in Bluetooth extras (Linux)
git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt # every chapter
pip install -r requirements/ch04.txt # or just one chapter
تحتوي ملفات requirements*.txt على نطاقات إصدارات. للحصول على الإصدارات الدقيقة التي تم اختبارها في CI، استخدم
requirements-lock.txt (وrequirements-lock-bluetooth.txt للمجموعة الاختيارية)
من أحدث إصدار.
مع pip 25.1 أو أحدث، يمكنك أيضًا تثبيت مجموعة فصل ما مباشرةً من
pyproject.toml باستخدام pip install --group ch04.
ينشر كل إصدار صورةً
لـ linux/amd64 وlinux/arm64 مع جميع تبعيات كل فصل، وnmap،
وtcpdump، وبيئة تشغيل BlueZ مثبّتة مسبقًا:
docker run --rm -it ghcr.io/eonraider/violent-python3
# Chapters that sniff or forge packets need raw-socket capabilities:
docker run --rm -it --cap-add=NET_RAW --cap-add=NET_ADMIN ghcr.io/eonraider/violent-python3
# Or build it yourself:
docker build -t violent-python3 . && docker run --rm -it violent-python3
تعمل الصورة بصلاحيات root لأن معظم فصول المقابس الخام (raw-socket) تحتاج ذلك. مع القدرات المذكورة أعلاه فقط، تظل الحاوية تعزل تلك السكربتات عن المضيف، لذا أضف فقط ما يحتاجه الفصل. يختلف Bluetooth (الفصل 5): فهو يحتاج إلى مساحة أسماء الشبكة الخاصة بالمضيف للوصول إلى المحوّل، على سبيل المثال باستخدام --net=host --cap-add=NET_RAW --cap-add=NET_ADMIN. هذا يزيل عزل الشبكة، لذا يمكن للحاوية رؤية جميع حركة مرور المضيف والتأثير عليها. تجنّب --privileged، فهو يمنح الحاوية أيضًا الوصول إلى كل جهاز على المضيف.
استخدم شارة Open in GitHub Codespaces أعلاه، أو افتح المجلد في VS Code أو JetBrains مع إضافة Dev Containers. تحتوي الحاوية
(.devcontainer/devcontainer.json) على الأدوات نفسها الموجودة في صورة Docker، بالإضافة إلى uv وgit والمترجمات، وتأتي مع منح قدرات المقابس الخام مسبقًا.
تستدعي بعض الفصول برامج خارجية أو تحتاج إلى مكتبات أصلية. تتضمن صورة Docker وحاوية التطوير هذه البرامج بالفعل؛ أما على المضيف فقم بتثبيتها بنفسك:
| مطلوبة لـ | Debian / Ubuntu / Kali | macOS (Homebrew) |
|---|---|---|
chapter02/nmap_scan.py، conficker.py | apt install nmap | brew install nmap |
| التقاط الحزم (الفصلان 4-5) | apt install libpcap0.8 tcpdump | مضمّنة |
مجموعة ch05-bluetooth | apt install libbluetooth-dev | غير مدعومة |
| الفصل | الموضوع | مجموعة uv | حزم PyPI | ملاحظات |
|---|---|---|---|---|
| 01 | مقدمة | ch01 | standard-crypt (ليس على Windows، Python 3.13+) | أُزيلت crypt من المكتبة القياسية في 3.13 (PEP 594)؛ تحافظ النسخة الاحتياطية (backport) على عمل passwd_crack.py. وكما هو الحال مع الوحدة الأصلية، فإنها تغلّف دالة libc crypt(3)، لذا لا يعمل passwd_crack.py على Windows. |
| 02 | اختبار الاختراق | ch02 | pexpect، python-nmap | يتطلب وجود برنامج nmap. يستخدم SSH وFTP ضد مضيفين تتحكم بهم. |
| 03 | التحقيقات الجنائية الرقمية | ch03 | beautifulsoup4، pillow، pypdf4، requests | يقرأ discover_networks.py وdump_recyclebin.py سجل Windows ويحتاجان إلى Windows مع صلاحيات المسؤول. تتضمن قواعد بيانات Firefox/Skype النموذجية وملف PDF. |
| 04 | تحليل حركة مرور الشبكة | ch04 | dpkt، geoip2، ipy، scapy | تتضمن ملفات .pcap نموذجية وقاعدة بيانات GeoLite2 City لعام 2020؛ استبدل قاعدة البيانات بتنزيل حديث قبل الاستخدام (انظر NOTICE). يحتاج التنصت المباشر إلى root / NET_RAW. |
| 05 | فوضى لاسلكية | ch05، ch05-bluetooth | scapy، pybluez (Linux، اختياري) | تحتاج سكربتات Wi-Fi إلى بطاقة في وضع المراقبة. يحتاج ninja_print.py إلى ارتباطات ObexFTP الخاصة بـ Python 2، والتي لا يوجد لها نقل إلى Python 3. |
| 06 | الاستطلاع على الويب | ch06 | beautifulsoup4، mechanicalsoup | تستهدف سكربتات Google وTwitter واجهات برمجية لم تعد موجودة؛ انظر ملاحظات التحويل. |
| 07 | التهرب من مكافحات الفيروسات | - | - | المكتبة القياسية فقط. |
يتم إنشاء عمود PyPI بواسطة python tools/deps_scan.py report، الذي يقرأ عبارات الاستيراد (imports) في كل فصل. تأتي ملاحظات نظام التشغيل والصلاحيات من ملاحظات التحويل وقد تكون غير مكتملة؛ التصحيحات مرحّب بها.
يبلغ حجم النسخة الكاملة (checkout) نحو 100 ميغابايت، معظمها بيانات نموذجية: قاعدة بيانات GeoLite2 بحجم 63 ميغابايت في chapter04/ وأرشيف بحجم 30 ميغابايت لمفاتيح SSH الضعيفة في Debian في chapter02/. لا توفّر النسخ السطحية (--depth 1) سوى القليل جدًا لأن تلك الملفات جزء من الشجرة الحالية. لتنزيل الفصول التي تريدها فقط:
git clone --filter=blob:none --sparse https://github.com/EONRaider/violent-python3.git
cd violent-python3
git sparse-checkout set chapter01 chapter03 # any chapters you want
أو تخطَّ الاستنساخ بالكامل واستخدم صورة Docker.
ينفّذ هذا الكود هجمات حقيقية: كسر كلمات المرور، والتخمين القسري لـ SSH، وحقن الحزم، واستغلال الشبكات اللاسلكية والبلوتوث. لا تشغّله إلا ضد أنظمة تملكها أو لديك إذن كتابي باختبارها.