كود مصدر "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 فقد أثبت أنه قديم جداً في طريقة تعامله مع الواجهات البرمجية الحالية بحيث لا يستحق عناء إعادة الهيكلة. إذا كنت مهتماً بالتعامل معها، فقم بإعادة الهيكلة وأرسل طلب سحب إلى هذا المستودع.

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