Size angarya gibi geldiği için test yazmaktan kaçındıysanız, bu pytest eğiticisi fikrinizi değiştirmelidir. Pytest törenin çoğunu kaldırır: devralınacak sınıflar ve hatırlanacak özel iddia yöntemleri yoktur. Bir test yalnızca iki satırdan oluşabilir.

Küçük bir alışveriş sepeti oluşturacağız ve onu adım adım test edeceğiz. Her şeyi Python 3.13’te pytest 9.2 ile çalıştırdık ve makinenizde farklılık gösterecek dosya yollarını ve zamanlama ayrıntılarını düzeltmiş olsak da gösterilen çıktı gerçektir.

Neden pytest?

Python, iyi çalışan unittest ile birlikte gelir, ancak pytest genellikle daha uygun seçimdir. İşte her birinde aynı kontrol:

Pytest ayrıca mevcut unittest testlerinizi de çalıştırabilir, böylece kademeli olarak geçiş yapabilirsiniz. Kapsama için pytest-cov ve paralel çalışmalar için pytest-xdist dahil olmak üzere geniş bir eklenti ekosistemine de sahiptir.

Pytest’i yükle

Python sanal ortam eğitimimizde açıklandığı gibi önce bir sanal ortam oluşturun ve ardından yükleyin:

pip install pytest
pytest --version

# pytest 9.2.0

cart.py ve test_cart.py olmak üzere iki dosya içeren bir proje klasörü oluşturun. Pytest, aşağıdaki adlandırma kurallarına göre testleri otomatik olarak bulur: test_*.py veya *_test.py adlı dosyalar, test ile başlayan işlevler ve Test ile başlayan sınıflar. Bir test alınmıyorsa kontrol edilecek ilk şey bir adlandırma uyuşmazlığıdır.

Test edilecek kod

# cart.py
class Cart:
    def __init__(self):
        self.items = []

    def add(self, name, price, qty=1):
        if qty < 1:
            raise ValueError("qty must be at least 1")
        self.items.append((name, price, qty))

    def total(self, discount=0):
        subtotal = sum(price * qty for _, price, qty in self.items)
        return round(subtotal * (1 - discount / 100), 2)

İlk testleriniz

# test_cart.py
from cart import Cart

def test_empty_cart_is_free():
    assert Cart().total() == 0

Bu tam bir test. Proje klasöründen pytest‘i çalıştırın ve bir geçme testi rapor eder. Bir içe aktarma hatası alırsanız, geçerli klasörü içe aktarma yoluna ekleyen python -m pytest olarak çalıştırın.

Okuma hataları

Pytest’in gerçekten parladığı yer burası. İşte kasıtlı olarak yanlış beklenen değere sahip bir test:

def test_wrong_total():
    c = Cart()
    c.add("Keyboard", 1500)
    assert c.total() == 1400

Ve çalıştırdığımızda yazdırdığı şey bu:

    def test_wrong_total():
        c = Cart()
        c.add("Keyboard", 1500)
>       assert c.total() == 1400
E       assert 1500.0 == 1400
E        +  where 1500.0 = total()

FAILED fail_example.py::test_wrong_total - assert 1500.0 == 1400
============================== 1 failed in 0.12s ==============================

> arızalı satırı işaretler ve E satırları gerçek değerleri gösterir. Özel bir mesaj eklemenize gerek yoktu, çünkü pytest assert ifadelerini yeniden yazar, böylece karşılaştırdıklarını rapor edebilirler. Listeler ve sözlükler için de aynısını yapar ve hangi öğelerin farklı olduğunu tam olarak belirtir.

İstisnaları test etme

Hata yönetimi de bir davranıştır ve testleri hak eder. pytest.raises yalnızca blok beklenen istisnayı ortaya çıkarırsa geçer:

import pytest

def test_rejects_zero_qty():
    with pytest.raises(ValueError, match="at least 1"):
        Cart().add("Pen", 10, qty=0)

İsteğe bağlı match argümanı, mesajı normal bir ifade kullanarak kontrol eder, böylece kazara farklı bir ValueError geçmeyecektir. Bunun gibi hataların nasıl oluşturulacağını ve ele alınacağını öğrenmek için Python istisna işleme kılavuzumuzu okuyun.

Armatürler: yeniden kullanılabilir kurulum

Çoğu testin önce hazırlanmış bir şeye ihtiyacı vardır. Bir fikstür bunu sağlayan bir işlevdir. Bunu @pytest.fixture ile süsleyin ve onu argüman olarak adlandıran herhangi bir test sonucu alır:

@pytest.fixture
def cart():
    c = Cart()
    c.add("Keyboard", 1500)
    c.add("Mouse", 500, qty=2)
    return c

def test_total(cart):
    assert cart.total() == 2500

Her teste varsayılan olarak yeni bir sepet verilir, dolayısıyla testler birbirini etkileyemez. Pytest, argüman adını fikstürün adıyla eşleştirir ve fikstürü asla kendiniz çağırmazsınız. @pytest.fixture bir dekoratördür ve bunu Python dekoratörlerinin açıklaması bölümünde açıklıyoruz.

Verimli temizleme

Daha sonra temizlemeniz gerektiğinde return yerine yield kullanın. Test başarısız olsa bile test bittiğinde yield‘ten sonraki kod çalışır:

@pytest.fixture
def temp_db():
    print("\nopen db")
    yield {"users": []}
    print("close db")

def test_db(temp_db):
    assert temp_db["users"] == []

Yazdırılan çıktıyı göstermek için -s ile çalışmak siparişin açık olduğunu, test ettiğini ve ardından kapatıldığını doğruladı.

Fikstür kapsamı ve conftest.py

Varsayılan olarak bir fikstür test başına bir kez çalıştırılır. Veritabanı veya tarayıcı gibi pahalı kurulumlar için ömrünü scope ile değiştirin:

Çeşitli dosyalar tarafından kullanılan fikstürleri conftest.py adlı bir dosyaya koyun. Pytest bunu otomatik olarak yükler, böylece testler herhangi bir içe aktarma işlemi yapmadan demirbaşlarını kullanabilir. Ancak paylaşılan kapsamlara dikkat edin çünkü bir testte yapılan değişiklik diğerine sızabilir.

Parametrelendirme: bir test, birçok giriş

Her değer için bir test kopyalamak yerine aşağıdaki durumları listeleyin:

@pytest.mark.parametrize("discount, expected", [
    (0, 2500),
    (10, 2250),
    (100, 0),
])
def test_discount(cart, discount, expected):
    assert cart.total(discount) == expected

Her satır kendi testi haline gelir ve bunu, dosyanın tamamını çalıştırmamızın ayrıntılı çıktısında görebilirsiniz:

test_cart.py::test_total PASSED                        [ 16%]
test_cart.py::test_discount[0-2500] PASSED             [ 33%]
test_cart.py::test_discount[10-2250] PASSED            [ 50%]
test_cart.py::test_discount[100-0] PASSED              [ 66%]
test_cart.py::test_rejects_zero_qty PASSED             [ 83%]
test_cart.py::test_empty_cart_is_free PASSED           [100%]

============================== 6 passed in 0.05s ==============================

Bir satır başarısız olursa diğerleri çalışmaya devam eder ve ad size tam olarak hangi değerlerin soruna neden olduğunu söyler. Parametrelendirmeyi cart fikstürüyle birleştirdiğimize dikkat edin. Hata bulma olasılığı yüksek değerleri seçmek için sınır değer analizini kullanın.

Kullanışlı yerleşik armatürler

Pytest birkaç hazır fikstür içerir. Bu ikisi özellikle kullanışlıdır ve her ikisi de bizim testimizde başarılı olmuştur:

def test_write_report(tmp_path):
    report = tmp_path / "report.txt"
    report.write_text("passed")
    assert report.read_text() == "passed"

def read_mode():
    return os.environ.get("APP_MODE", "dev")

def test_mode(monkeypatch):
    monkeypatch.setenv("APP_MODE", "staging")
    assert read_mode() == "staging"

tmp_path her teste benzersiz bir geçici klasör verir, böylece testler hiçbir zaman gerçek dosyalara dokunmaz. monkeypatch ortam değişkenlerini veya niteliklerini değiştirir ve test sona erdiğinde değişikliği geri alır. Bir diğer kullanışlı özellik ise, yazdırılan çıktıyı yakalayıp kontrol edebilmenizi sağlayan capsys‘tür.

İşaretçiler: atla ve xfail

İşaretleyiciler testlere etiketler ve davranışlar ekler:

@pytest.mark.skip(reason="payment sandbox is down")
def test_payment():
    assert False

@pytest.mark.xfail(reason="floating point")
def test_rounding():
    assert 0.1 + 0.2 == 0.3

skip testi hiç çalıştırmaz. xfail onu çalıştırıyor ancak başarısızlık bekliyor, bu nedenle bilinen bir sorun yapınızı bozmaz. Aynı dosyadaki diğer ekstra testlerle birlikte çalışmamız 3 passed, 1 skipped, 1 xfailed olarak özetlenmiştir. Bu arada yuvarlama testi gerçekten başarısız oluyor: kayan nokta aritmetiğinde 0,1 + 0,2 tam olarak 0,3 değil. Ondalık sayıları karşılaştırırken pytest.approx(0.3) kullanın.

Ayrıca @pytest.mark.slow gibi kendi işaretçilerinizi oluşturabilir ve yalnızca pytest -m slow ile bunları çalıştırabilir veya -m "not slow" ile bunları dışarıda bırakabilirsiniz. Uyarılardan kaçınmak için özel işaretçileri yapılandırma dosyanıza kaydedin.

Yararlı komut satırı bayrakları

CI’da pytest çalıştırılıyor

Testler, her değişiklikte otomatik olarak çalıştırıldığında çok değerlidir. Minimal bir GitHub Eylemleri işi şuna benzer:

steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-python@v5
    with:
      python-version: "3.13"
  - run: pip install -r requirements.txt
  - run: python -m pytest

Pytest, testler başarısız olduğunda sıfırdan farklı bir kodla çıkar; bu da boru hattının durmasına neden olur. Bu iş akışı dosyasını biz yürütmedik, dolayısıyla projenize uyarlayın. GitHub Actions CI/CD kılavuzumuz ayrıntıları açıklamaktadır. Pytest ayrıca, Selenium Python eğiticimiz ve Page Object Model eğiticimiz‘in gösterdiği gibi, tarayıcı testleri için de iyi çalışır.

Son sözler

Artık çoğu Python test paketi için ihtiyacınız olan şeye sahipsiniz: düz iddialar, kurulum için fikstürler, varyasyonlar için parametrelendirme ve hız için birkaç işaret. Küçük başlayın. Yakın zamanda bir hatayı düzelttiğiniz bir işlevi seçin ve önce bu hata için bir test yazın. Her düzeyde neyi test etmeniz gerektiğinden emin değilseniz birim ve entegrasyon testi hakkında bilgi edinin.

Sık sorulan sorular

Öğrenmeye devam et