المتوقَّع مقابل الفعلي: أول assert

١assert: التأكيد الذي يصرخ عند الخطأ

الطباعة اليدوية للمقارنة مملّة وتحتاج عينًا تقرؤها. بايثون يقدّم assert: تكتب الشرط الذي يجب أن يكون صحيحًا، فإن تحقّق مرّ بصمت، وإن فشل أوقف البرنامج بخطأ واضح. هذا أساس كل اختبار آليّ.

def add(a, b):    return a + b assert add(2, 3) == 5        # صحيح: يمرّ بصمتassert add(0, 0) == 0        # صحيحassert add(-1, 1) == 0       # صحيحprint("كل التأكيدات نجحت ✓")

لا شيء يُطبَع إلا الرسالة الأخيرة؛ أي أن كل التأكيدات صحيحة. هذا هو «الأخضر»: الاختبار يمرّ.

٢حين يفشل التأكيد

جرّب الآن تأكيدًا خاطئًا، وراقب كيف يتوقّف البرنامج بـ AssertionError:

def add(a, b):    return a + b assert add(2, 2) == 5, "2 + 2 يجب أن يساوي 4 لا 5"print("لن يُطبَع هذا السطر")

الرسالة بعد الفاصلة تشرح ماذا توقّعنا. اكتبها دائمًا: رسالة فشلٍ واضحة توفّر دقائق من الحيرة. لاحظ أن السطر الأخير لم يُطبَع لأن البرنامج توقّف عند الفشل.

٣اختبارٌ منظّم بدوال

نجمع التأكيدات في دوال test_، ونشغّلها بمُشغّلٍ بسيط يعدّ النجاح والفشل — بذرة إطار الاختبار الذي سنتعلّمه لاحقًا:

def to_upper(s):    return s.upper() def test_basic():    assert to_upper("abc") == "ABC" def test_empty():    assert to_upper("") == "" def test_arabic_passthrough():    assert to_upper("سلام") == "سلام"   # العربية بلا حالة أحرف # مُشغّل بسيطtests = [test_basic, test_empty, test_arabic_passthrough]passed = 0for t in tests:    try:        t(); passed += 1    except AssertionError:        print("فشل:", t.__name__)print("نجح", passed, "من", len(tests))