كود مصدر "Violent Python" للبايثون 3

كود مصدر الكتاب "Violent Python" للمؤلف TJ O'Connor. تم تحويل الكود بالكامل إلى بايثون 3، وإعادة تنسيقه للامتثال لمعايير PEP8، وإعادة هيكلته لإزالة مشاكل الاعتماد على المكتبات القديمة المهجورة.

لقد قمت بنشر تحويل مشابه لهذا على الكود المصدري لكتاب "Black Hat Python" لجاستن سايتز. تحقق منه هنا إذا لم تكن قد قمت به بعد.

الاستخدام

ببساطة أنشئ دليلاً جديداً (DIR) للمشروع، وأنشئ بيئة افتراضية أو venv له (موصى به)، واستنسخ هذا المستودع باستخدام git clone ثم ثبّت المتطلبات باستخدام pip install.

user@host:~/DIR$ git clone https://github.com/EONRaider/violent-python3
user@host:~/DIR$ python3 -m venv venv
user@host:~/DIR$ source venv/bin/activate
(venv) user@host:~/DIR$ pip install -r requirements.txt

ملاحظات

• تمت تسمية الأدلة والملفات بطريقة تجعلها مرتبطة بسهولة بالمحتوى المقدّم في كل فصل.
• تم استبدال الاستخدام المتكرر لربط السلاسل النصية من قبل المؤلف بترابط النصوص (string interpolation) من أجل السماح بقراءة أفضل والامتثال لمعيار أكثر حداثة.
• أسماء الملفات والمتغيرات والدوال والفئات والطرق أصبحت الآن متوافقة مع معايير تسمية PEP 8.
• لقد تم استبدال مكتبة optparse المهجورة الآن بمكتبة argparse في جميع أنحاء الكود المصدري. أصبح تحليل جميع الوسائط محتوىً الآن تحت نطاق تنفيذ __main__ لكل ملف. جميع وسائط سطر الأوامر CLI التي كانت إلزامية لتنفيذ البرامج النصية لكنها عُوملت كاختيارية في الكود الأصلي تُنفَّذ الآن كوسائط موضعية. رسالة الاستخدام أصبحت متاحة لجميع البرامج النصية التي تستخدم argparse عن طريق توفير وسيط -h إلى سطر الأوامر CLI. إن إسناد مسؤوليات كل من الحدود والكائن المتحكم إلى محلل سطر الأوامر CLI ليس بالتأكيد الخيار الأفضل من حيث بنية البرمجيات، لكنه تُرك كما هو نظراً لضرورة الامتثال لنية المبرمج الأصلي.
• جميع حالات انتهاك PEP 8: E722 do not use bare except تمت إعادة هيكلتها باستخدام عبارات استثناء أكثر تحديداً.
• كان المؤلف معتاداً على فتح الملفات/قواعد البيانات وتركها على هذه الحالة بدلاً من استدعاء close() على كائنات الملف/قاعدة البيانات المفتوحة. لهذا السبب تمت إعادة هيكلة جميع حالات التعامل مع الملفات وقواعد البيانات باستخدام مديري السياق.
• تمت إزالة استخدام التعليقات التي تشير إلى الترميز الذي سيستخدمه المفسر (وتحديداً # -*- coding: utf-8 -*-) بسبب توحيد UTF-8 كترميز افتراضي لبايثون 3 (بدلاً من ASCII في بايثون 2).
• على الرغم من أنها غير ملائمة تماماً من منظور أفضل الممارسات، فقد تُرك استخدام المتغيرات العالمية دون تغيير لتفادي انحرافات كبيرة عن منطق الكود الأصلي.
• تمت إعادة هيكلة الكود الموجود في الفصل 5 من الكتاب على الرغم من أنه من الناحية العملية يمكن اعتباره تاريخياً في أحسن الأحوال. جزء كبير من وظائفه لا يعتمد فقط على حالات محددة جداً ذكرها المؤلف كأمثلة، بل أيضاً على استغلال ثغرات لم تعد واقعية في السنوات الأخيرة (مثل التقاط حركة مرور الشبكات اللاسلكية 802.11 التي لا تزال تعتمد على خوارزمية أمان WEP لتشفير حركة المرور، أو الأسوأ من ذلك، التي لا تحتفظ بأي أمان على الإطلاق) أو التوقع غير المنطقي لاقتناء طائرة بدون طيار (UAV) محددة من قبل القارئ إذا كان ينوي رؤية الكود يعمل. ولتفادي القول مباشرةً إن الجهد المبذول في قراءة هذا الفصل شبه عديم الفائدة، يمكنني أن أضيف أنه يمكن استخلاص بعض الفائدة من الكود المتعلق بالتقاط طلبات الاستكشاف (probing) والمنارات (beacon requests), رغم ذلك.
• أما الكود في الفصل 6 الذي يشير إلى Google وTwitter فقد أثبت أنه قديم جداً في طريقة تعامله مع الواجهات البرمجية الحالية بحيث لا يستحق عناء إعادة الهيكلة. إذا كنت مهتماً بالتعامل معها، فقم بإعادة الهيكلة وأرسل طلب سحب إلى هذا المستودع.

إعادة الهيكلة

يمكن اعتبار أن الملفات غير المدرجة أدناه قد أعيدت هيكلتها بطريقة أو بأخرى على النحو المحدد في قسم "ملاحظات".

• كان chapter01/vuln_scanner.py مهيكلاً بطريقة تجعل ملفاً غير موجود يؤدي إلى استثناء OSError في وقت التشغيل. لهذا السبب، تم نقل التحكم بالتكرار الذي يستدعي check_vulns() إلى العبارة الشرطية المعرفة في الدالة الرئيسية.
• chapter02/nmap_scan.py ينفذ دالة رئيسية فقط بغرض استدعاء مكتبة optparse المهجورة، والتي تم استبدالها بـ argparse. ولهذا السبب تمت إزالة الدالة الرئيسية. كان هناك تكرار هيكل تحكم كان جزءاً من استدعاء optparse في الكود الأصلي، وقد نُفذ بطريقة تجعل استدعاءً جديداً لـ nmap يُنفذ لكل منفذ يتم فحصه. تم نقل التكرار إلى nmap_scan لمنع إهدار الدورات.
• تم نقل كود التهيئة في chapter02/ssh_command.py إلى نطاق تنفيذ __main__. أسماء المتغيرات المستخدمة في النطاق الخارجي التي كانت تتعارض مع أسماء معاملات الدوال تم تغييرها. كانت معلومات المطالبة (prompt) المرتجعة مشفرة في الأصل، والآن تم فك تشفيرها من أجل تحسين القراءة.
• استورد chapter02/ssh_brute.py مكتبة pxssh كمكتبة مستقلة، لكن في الحقيقة هي مكتبة داخل مكتبة . أدى الخطأ إلى وتم تصحيحه. الكود نفسه كما ورد في الكتاب كان مليئاً بأخطاء المسافات البادئة مما جعله غير قابل للاستخدام وقد أُعيد إلى حالة تعمل.

الترجمات

يمكن الاطلاع على المساهمات بلغات أخرى هنا:

• تُرجم إلى التركية بواسطة Bedirhan Budak

المساهمة

من باب المنطق السليم، حاول أولاً مناقشة التغيير الذي ترغب في إجرائه على هذا المستودع عبر issue.

1. تأكد من أن التعديلات التي ترغب في تقديمها تؤدي بالفعل إلى طلب سحب (pull request). يجب طلب تغيير سطر أو سطرين عبر issue بدلاً من ذلك.
2. إذا لزم الأمر، حدّث ملف README.md بالتفاصيل المتعلقة بالتغييرات على بنية المشروع.
3. تأكد من أن رسائل الالتزام التي تتضمن التعديلات تتبع معياراً. إذا كنت لا تعرف كيفية المتابعة، هنا هو مرجع رائع حول كيفية القيام بذلك.
4. ستتم مراجعة طلبك في أقرب وقت ممكن (عادةً خلال 48 ساعة).