الدروس ولعبة التعلّم

Debugging Python

ابحث عن أخطاء حقيقية وأصلحها في نصوص برمجية لمجس في أعماق البحر يعمل على Raspberry Pi 4، مع رسائل الأخطاء والسجلات نفسها التي يطبعها هذا المحرك تمامًا.

الدورة

Debugging Python is an intermediate Coding course in seven lessons, after Python from zero and Fix the bug. The scripts belong to Nereus, a deep sea probe, and every lesson starts with one of them broken: a real bug that crashes it or quietly gets a number wrong. You find it with the lesson's technique, fix it, and the check proves the fixed output. The circuits are gallery Pi builds: two lamps, a PIR standing in for the sonar, a button and a lamp, and the traffic light module.

  1. قراءة تتبع الأخطاء: سكربت عمق ينهار، يُقرأ من الأسفل إلى الأعلى؛ قراءة سيئة في البيانات، واسم مكتوب خطأً، ومفتاح قاموس مفقود، ومدخل تسلسلي سيئ يُلتقط باستخدام except ValueError بينما يُبقي traceback.print_exc() الدليل.
  2. print مقابل logging: مصباح تلامس سونار لا يضيء أبدًا، يُكتشف بطباعة واحدة في موضعها الصحيح (عدّاد يُصفَّر داخل حلقته)، ثم تتحول الطباعات إلى logging بمستويات واسم مسجِّل وأرقام أسطر.
  3. التوكيدات: خزان توازن ينزل تحت الفراغ دون كلمة، وتوكيد يوقفه عند أول قيمة خاطئة، والإصلاح، وتوكيدات تتحول إلى اختبارات صغيرة تكتشف خلل تجاوز حد عند زميل.
  4. تنصيف الخلل: سونار يضع قاع البحر عند 21,579 م، يُكتشف بفحص منتصف السلسلة (خلل أسبقية عوامل تشغيل)، ثم نفس التنصيف لإيجاد نبضة سيئة واحدة بين 1,000 في عشرة اختبارات، وأول إصدار برنامج ثابت معطوب في أربعة، بالطريقة التي يعمل بها git bisect.
  5. الخطأ بواحد: فهرس واحد بعد النهاية، وحلقة تتخطى أول قراءة، وحد منطقة محيطية في الجهة الخاطئة (يُضاء على أضواء المرور)، ومشكلة عمود السياج، كلها تُكتشف بقائمة تحقق واحدة: الأول، الأخير، كم العدد.
  6. أخطاء الحالة: مفتاح تبديل ينهار لأن الإسناد يجعل الاسم محليًا، وقائمة افتراضية تُشارك بين كل غطسة، ونسخة احتياطية تفرغ نفسها، وسجل يتسرب من غطسة إلى التالية.
  7. التحدي الأخير: ثلاثة سكربتات معطوبة: الخاتمة.

الخاتمة

قبل غطسة بساعة، تفشل ثلاثة سكربتات. منارة سطحية تبقى مضاءة بدل الوميض (خلل نسخ ولصق، يُكتشف بقراءة الحلقة كمصباح)، وملخص سجل غطسات ينهار في سطره الأول (ترويسة CSV، تُكتشف من تتبع الأخطاء)، وزر الوضع يموت عند ضغطته الثالثة (عدّاد لا يلتف أبدًا، يُكتشف بقائمة تحقق الخطأ بواحد). كل إصلاح يُثبت على الدائرة، وتنتهي الدورة بتقرير خلل مكتوب لكل واحد: العرَض، والسبب، والإصلاح، والإثبات.

ما يفعله محرك Pi بشكل مختلف

يشغّل الـ Pi إصدار MicroPython 1.29، والتصحيح هو الموضع الذي تهم فيه رسائله. الدروس تقتبس حرفيًا ما يطبعه:

  • تتبع الأخطاء يسرد الملف والسطر والدالة لكل إطار، لكن ليس السطر المصدري ولا أسهم CPython، لذا تفتح السطر بنفسك.
  • بعض الرسائل صياغتها مختلفة: unsupported types for __sub__: 'str', 'int'، وname 'x' isn't defined، وinvalid syntax for integer with base 10، وKeyError يطبع مفتاحه دون علامات اقتباس.
  • الإسناد إلى متغير عام دون global يثير NameError: local variable referenced before assignment، وليس UnboundLocalError كما في CPython، ولا يذكر اسم المتغير.
  • logging هو نفسه في CPython: المستويات نفسها، والتنسيقات نفسها (بما فيها %(lineno)d) والفخاخ نفسها، مثل عدم فعل basicConfig شيئًا بعد الرسالة الأولى ما لم تمرّر force=True.
  • لا يمكن تثبيت pytest، لذا فإن الاختبارات دوال عادية مبنية على assert، وهذا كل ما هو عليه اختبار الوحدة.