بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 43: تست‌نویسی Testing

یاد می‌گیریم درستی کد را با تست خودکار ثابت کنیم: از assert ساده تا unittest.TestCase، حالت‌های مرزی و فکر کردن به روش TDD.

در این جلسه یاد می‌گیری

درس

assert condition, message اگر شرط نادرست باشد AssertionError پرتاب می‌کند. ساده‌ترین تست همین است: یک تابع test_... که چند assert دارد. اما assert را برای اعتبارسنجی ورودی کاربر در کد اصلی استفاده نکنید، چون با python -O حذف می‌شود.

def add(a, b):
    return a + b

def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0, "inverse numbers"

test_add()
print("test_add passed")

unittest چارچوب تست کتابخانه‌ی استاندارد است. هر متدی که نامش با test شروع شود یک تست است. به جای assert از متدهایی مثل assertEqual، assertTrue و assertIn استفاده کنید تا پیام خطا دقیق باشد.

import unittest

class TestSlugify(unittest.TestCase):
    def test_spaces(self):
        self.assertEqual(slugify("Hello World"), "hello-world")

در محیط‌های واقعی تست‌ها را با python -m unittest یا pytest اجرا می‌کنیم. این‌جا آن‌ها را برنامه‌ای اجرا می‌کنیم: loader تست‌ها را جمع می‌کند و TextTestRunner با یک StringIO گزارش متنی را بی‌صدا نگه می‌دارد. سپس از شیء result می‌پرسیم چه شد.

import io

suite = unittest.defaultTestLoader.loadTestsFromTestCase(TestSlugify)
result = unittest.TextTestRunner(stream=io.StringIO()).run(suite)
print(result.testsRun, result.wasSuccessful(), len(result.failures))

assertRaises به‌عنوان مدیر زمینه بررسی می‌کند که کد خطای مورد انتظار را پرتاب کند. setUp قبل از هر تست اجرا می‌شود تا هر تست با داده‌ی تازه و مستقل شروع شود.

class TestCart(unittest.TestCase):
    def setUp(self):
        self.cart = []
    def test_bad_price(self):
        with self.assertRaises(ValueError):
            float("abc")

تست خوب حالت‌های مرزی را می‌پوشاند: لیست خالی، صفر، عدد منفی، یک عنصر، مقدار دقیقاً روی مرز. با subTest چند ورودی را در یک تست بررسی کنید. در TDD اول تستی می‌نویسید که شکست بخورد، بعد کمترین کد برای پاس شدن و در آخر بازسازی (refactor).

def test_cases(self):
    for text, expected in [("", 0), ("a b", 2)]:
        with self.subTest(text=text):
            self.assertEqual(word_count(text), expected)

مثال‌های این جلسه

چالش‌ها

  1. First Assertions (آسان)
  2. Assertion Message (آسان)
  3. A Test Function (آسان)
  4. First TestCase (متوسط)
  5. Testing for Exceptions (متوسط)
  6. Edge-case Table (متوسط)
  7. Fresh Fixture with setUp (متوسط)
  8. Test-Driven Word Count (سخت)
  9. Parameterised with subTest (سخت)
  10. Testing a Bank Account (سخت)
  11. Spot the Failing Test (متوسط)
  12. Injecting a Fake Clock (سخت)

بیشتر بخوان

← جلسه‌ی 42: پروژه: تحلیل‌گر لاگ جلسه‌ی 44: اشکال‌زدایی و لاگ‌گیری →