آزمون مرزی با pytest؛ یک تابع تست برای چند سناریوی واقعی

import pytest

def shipping_cost(amount):
    if amount < 0:
        raise ValueError("amount must be non-negative")
    return 0 if amount >= 1_000_000 else 50_000

@pytest.mark.parametrize("amount, expected", [
    pytest.param(0, 50_000, id="zero"),
    pytest.param(999_999, 50_000, id="below-threshold"),
    pytest.param(1_000_000, 0, id="at-threshold"),
    pytest.param(1_000_001, 0, id="above-threshold"),
])
def test_shipping_cost(amount, expected):
    assert shipping_cost(amount) == expected

def test_negative_amount():
    with pytest.raises(ValueError):
        shipping_cost(-1)

پس از python -m pip install pytest، فایل را با python -m pytest -q test_shipping.py اجرا کنید؛ انتظار 5 passed داریم. این مثال عدد صحیح و واحد تومان را فرض می‌کند و اعتبارسنجی نوع ورودی را به لایه فراخواننده واگذار کرده است.

برای استفاده بیرون از تست، منطق را در shipping.py قرار دهید. این نسخه علاوه بر مقدار، نوع ورودی را هم بررسی می‌کند. bool در پایتون زیرنوع int است، اما True مبلغ سفارش معناداری نیست و صریحاً رد می‌شود.

# shipping.py
FREE_FROM = 1_000_000
STANDARD_FEE = 50_000

def shipping_cost(amount):
    if isinstance(amount, bool) or not isinstance(amount, int):
        raise TypeError("amount must be an integer currency value")
    if amount < 0:
        raise ValueError("amount must be non-negative")
    return 0 if amount >= FREE_FROM else STANDARD_FEE

واحد قرارداد همان تومان و مبلغ صحیح است. اگر محصول به عدد اعشاری یا ریال نیاز دارد، قرارداد و تست را هماهنگ تغییر دهید. ثابت‌ها در یک محل‌اند، ولی انتظار تست را از همین ثابت‌ها نسازید؛ در آن صورت تغییر اشتباه هم‌زمانِ آستانه ممکن است از دید تست پنهان بماند.

این فایل کنار shipping.py قرار می‌گیرد. مرز و انتظارها از قانون محصول آمده‌اند و فهرست ورودی‌های نامعتبر، تبدیل ضمنی رشته یا bool به پول را عمداً رد می‌کند. هر ورودی یک مورد جدا در گزارش pytest است.

# test_shipping_contract.py
import pytest
from shipping import shipping_cost

@pytest.mark.parametrize("amount, expected", [
    (0, 50_000), (999_999, 50_000),
    (1_000_000, 0), (1_000_001, 0),
])
def test_boundary_contract(amount, expected):
    assert shipping_cost(amount) == expected

@pytest.mark.parametrize("amount", [None, "1000000", True, 1.5])
def test_rejects_non_integer_values(amount):
    with pytest.raises(TypeError):
        shipping_cost(amount)

@pytest.mark.parametrize("amount", [-1, -100_000])
def test_rejects_negative_values(amount):
    with pytest.raises(ValueError):
        shipping_cost(amount)

فقط این فایل باید 10 passed بدهد. اگر تابع را موقتاً به > تغییر دهید، مورد مبلغ روی مرز شکست می‌خورد. تغییر آزمایشی را برگردانید؛ نتیجه قرمز این مرحله، نشانه حساس‌بودن تست به خطای هدف است.

فرمان‌ها را از پوشه دو فایل اجرا کنید. استفاده از python -m کمک می‌کند pytest همان مفسر فعال اجرا شود. در مخزن واقعی، نسخه وابستگی‌ها را در ابزار مدیریت پروژه ثبت کنید؛ این دستور نصب برای محیط آموزشی است.

python -m pip install pytest
python -m pytest -q test_shipping_contract.py
python -m pytest -q test_shipping_contract.py -k boundary
python -m pytest test_shipping_contract.py --maxfail=1 --junitxml=reports/shipping.xml

اجرای کامل ۱۰ مورد و انتخاب boundary چهار مورد را می‌سنجد. خروج غیرصفر باید مرحله CI را ناموفق کند؛ فایل JUnit برای نگهداری نتیجه است و شکست تست را به موفقیت تبدیل نمی‌کند. گزارش حاوی ورودی حساس را در artifact عمومی منتشر نکنید.