الاختبارات الوحدوية

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

1اختبار بثلاث خطوات

هذه دالة خصم واختباراتها. نشغلها بـ unittest ونطبع ملخصًا ثابتًا (pytest يكتشفها بنفس الأسماء):

import io
import unittest

def apply_discount(price, percent):
    if not 0 <= percent <= 100:
        raise ValueError("percent must be 0-100")
    return round(price * (100 - percent) / 100, 2)

class DiscountTests(unittest.TestCase):
    def test_regular_discount(self):
        price, percent = 50, 20          # arrange
        result = apply_discount(price, percent)  # act
        self.assertEqual(result, 40)     # assert

    def test_zero_and_full(self):
        self.assertEqual(apply_discount(50, 0), 50)
        self.assertEqual(apply_discount(50, 100), 0)

    def test_rejects_bad_percent(self):
        with self.assertRaises(ValueError):
            apply_discount(50, 120)

suite = unittest.defaultTestLoader.loadTestsFromTestCase(DiscountTests)
result = unittest.TextTestRunner(stream=io.StringIO()).run(suite)
print("ran:", result.testsRun, "failures:", len(result.failures), "ok:", result.wasSuccessful())

بنفس الفكرة في pytest، أقصر:

import pytest
from shop import apply_discount

@pytest.mark.parametrize("price, percent, expected", [
    (50, 20, 40), (50, 0, 50), (50, 100, 0), (19.99, 15, 16.99),
])
def test_apply_discount(price, percent, expected):
    assert apply_discount(price, percent) == expected

def test_rejects_bad_percent():
    with pytest.raises(ValueError):
        apply_discount(50, 120)

2ما الذي تختبره؟

الحالة العادية، ثم الأطراف: صفر، فارغ، أكبر قيمة، سالب، None، ونص بالعربية. ثم الأخطاء المتوقعة. وكل خطأ أصلحته يحصل على اختبار باسمه حتى لا يعود.

3البدائل الوهمية

دالة ترسل رسالة SMS لا يجب أن ترسل رسالة حقيقية في كل اختبار. نستبدل المرسل ببديل يسجّل ما طُلب منه:

from unittest.mock import Mock

def notify_ready(order, sms):
    if order["status"] != "ready":
        return False
    sms.send(order["phone"], f"Order {order['id']} is ready")
    return True

sms = Mock()
print(notify_ready({"id": 7, "status": "ready", "phone": "0500000000"}, sms))
sms.send.assert_called_once_with("0500000000", "Order 7 is ready")
print(notify_ready({"id": 8, "status": "new", "phone": "0500000000"}, sms))
print("send calls:", sms.send.call_count)

مثال محلول

المسألة: تقرير يقول «الفاتورة بخصم 15% على 19.99 أعطت 16.991». الاختبار أولًا: assert apply_discount(19.99, 15) == 16.99 يفشل. الإصلاح: round(..., 2). النتيجة: الاختبار يمر، ويبقى في الملف ليحرس هذا الخطأ للأبد.

خرافة مقابل حقيقة

اختبر فهمك

بطاقات مراجعة سريعة

تحقق من فهمك