Auf einen Blick
Oft unterscheiden sich Tests nur in den Testdaten. Statt die gleiche Testfunktion mehrmals zu kopieren, schreiben Sie sie einmal und geben die Testfälle als Tabelle an.
PyTest führt die Funktion für jede Zeile der Tabelle als eigenen Test aus.
Sie können
@pytest.mark.parametrize in einer Testfunktion zusammenfassen,def test_minmax_normal(): assert minmax([3, 1, 2]) == (1, 3) def test_minmax_one_element(): assert minmax([5]) == (5, 5) def test_minmax_negative(): assert minmax([-4, -9, -1]) == (-9, -1)
Die drei Tests sind identisch bis auf die Daten. Kommt ein Testfall dazu, wird nochmals kopiert. Das verstösst gegen das Prinzip DRY (Don't Repeat Yourself).
import pytest from minmax import minmax @pytest.mark.parametrize('numbers, expected', [ ([3, 1, 2], (1, 3)), ([5], (5, 5)), ([-4, -9, -1], (-9, -1)), ([2, 2, 2], (2, 2)), ([1.5, 0.5], (0.5, 1.5)), ]) def test_minmax(numbers, expected): assert minmax(numbers) == expected
PyTest zeigt jeden Testfall einzeln an:
test_minmax.py::test_minmax[numbers0-expected0] PASSED test_minmax.py::test_minmax[numbers1-expected1] PASSED test_minmax.py::test_minmax[numbers2-expected2] PASSED ...
Die automatischen Namen wie numbers0-expected0 sagen wenig. Mit pytest.param und id geben Sie jedem Testfall einen Namen:
@pytest.mark.parametrize('numbers, expected', [ pytest.param([3, 1, 2], (1, 3), id='normal'), pytest.param([5], (5, 5), id='ein Element'), pytest.param([-4, -9, -1], (-9, -1), id='nur negative'), ]) def test_minmax(numbers, expected): assert minmax(numbers) == expected
test_minmax.py::test_minmax[normal] PASSED test_minmax.py::test_minmax[ein Element] PASSED test_minmax.py::test_minmax[nur negative] PASSED
Auch Tests mit pytest.raises (LU03e) lassen sich parametrisieren:
@pytest.mark.parametrize('amount', [0, -0.01, -100]) def test_deposit_invalid_amount(amount): account = BankAccount('Anna', 100.0) with pytest.raises(ValueError): account.deposit(amount)
Trennen Sie gültige und ungültige Testfälle in zwei Testfunktionen. Sonst braucht der Test ein if, und ein Test mit Verzweigungen ist selbst fehleranfällig.
Die Tabelle in parametrize entspricht den Zeilen einer Testfallbeschreibung aus LU01c: Eingabe und SOLL. So lässt sich eine Liste von Testfällen direkt in einen automatisierten Test übertragen. Dieses Vorgehen heisst datengetriebenes Testen (siehe LU02a).