الكود المصدري لـ Python 3 "Black Hat Python"

الكود المصدري للكتاب "Black Hat Python" بقلم جاستن سايتز. تم تحويل الكود بالكامل إلى Python 3، وإعادة تنسيقه للامتثال لمعايير PEP8، وإعادة هيكلته لإزالة مشكلات الاعتماد المتعلقة باستخدام مكتبات قديمة.

على الرغم من أنه كان يمكن تنفيذ العديد من التحسينات في الكود المصدري المعروض في جميع أنحاء الكتاب، إلا أن الكود تُرك دون تغيير قدر الإمكان بحيث يمكن للقارئ تطبيق هذه التعديلات كما يراه مناسباً. الكود كما هو يحتاج إلى جهود إعادة هيكلة جادة تتراوح من docstrings إلى type hinting ومعالجة الاستثناءات، ناهيك عن تحسينات مثل context managers، ولكن هذه المشكلات بحد ذاتها قد تعود بالفائدة على القارئ إذا كان ينوي تنفيذها. كما أنه يقدّم العديد من الأخطاء الناتجة عن المسافات البادئة (indentation) والتي تم تصحيحها لتجنب الأخطاء الفادحة أثناء التشغيل.

لقد قمت بنفسي بتوفير تحويل مماثل لهذا التحويل للكود المصدري للكتاب "Violent Python" بقلم TJ O'Connor. ألقِ نظرة هنا إذا لم تكن قد فعلت ذلك بعد.

الاستخدام

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

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

ملاحظات

• بعض الأكواد المعروضة في الكتاب كانت مفقودة من مستودع الكود الخاص بالمؤلف والمتاح من موقع "no starch press"، وتمت إضافتها إلى الفصول المعنية. تم تطبيق اصطلاح تسمية أكثر دقة على الملفات عند الحاجة لربطها بالكود المعروض في الكتاب.
• تم إصلاح أخطاء بسيطة كانت تولّد تحذيرات من المفسّر في جميع أنحاء الكود دون تغيير خصائصه.
• تمت إضافة الملفات المساعدة اللازمة لجعل الكود يعمل إلى فصولها المعنية.
• كملاحظة شخصية جانبية، كان بإمكان المؤلف كتابة كود أنظف دون المساس بسرعة التنفيذ المطلوبة لمهام الاختراق الأخلاقي. السبب الذي جعله لا يفعل ذلك يظل مجهولاً.

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

إصلاحات أخطاء حرجة كان لا بد من إجرائها لتنفيذ الكود المصدري بشكل صحيح وتجنب الأخطاء الفادحة:

• تطلّب chapter02/bh_sshserver.py مفتاح RSA الموجود في ملف test_rsa.key، وهو الآن مدرج في الدليل المقابل.
• chapter03/sniffer_ip_header_decode.py وsniffer_with_icmp.py وscanner.py جميعها كانت بها مشكلات خطيرة في تعريف أحجام حزم IP وقابلية النقل بين معماريات 32/64-بت بسبب مشاكل في تنفيذ struct. مزيد من المعلومات حول هذه المشكلات في هذا الموضوع على Stack Overflow.
• استخدم chapter03/scanner.py مكتبة netaddr، التي لم تعد تُصان وتقدّم الكثير من عدم التوافق مع Python 3. لهذا السبب تمت إعادة هيكلة الكود وأصبح يستخدم وحدة ipaddress من stdlib الخاصة بـ Python.
• استخدم chapter04/arper.py وmail_sniffer.py مكتبة ، وهي غير متوافقة مع Python 3. لهذا السبب تمت إعادة هيكلة الكود وأصبح يستخدم مكتبة .

الترجمات

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

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

المساهمة

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

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