CKTIS / Python
Podtesty w unittest: równość i oczekiwane wyjątki
Sprawdzaj wiele danych wejściowych w jednej metodzie testowej, oznaczaj nieudane podtesty i rozróżniaj sprawdzanie równości od oczekiwania na wyjątek.
Wersja: Python 3.12
Składnia
with self.subTest("case label", value=value):
self.assertEqual(actual, expected)
with self.subTest(value=value):
self.assertRaises(ExpectedError, func, *args, **kwargs)
with self.assertRaises(ExpectedError):
func(*args, **kwargs)W Pythonie 3.12 metoda unittest.TestCase.subTest zwraca menedżer kontekstu. Użyj with self.subTest("opis", value=value):, aby wydzielić pojedynczy podtest, na przykład dla jednej iteracji pętli. Opcjonalny komunikat msg i argumenty nazwane **params pomagają zidentyfikować podtest w raporcie o niepowodzeniu; nie są przekazywane do sprawdzanej funkcji.
Bez trybu failfast nieudana asercja kończy bieżący blok with, ale metoda testowa biegnie dalej za nim i może wykonać kolejne podtesty. Podtesty nie są osobnymi metodami testowymi i nie uruchamiają oddzielnie setUp() ani tearDown(). W trybie failfast nie zakładaj, że kolejne podtesty się wykonają.
self.assertEqual(actual, expected) sprawdza równość wartości (==), nie tożsamość obiektów (is). Jeśli wartości nie są równe, zgłasza niepowodzenie asercji. Umieść ją wewnątrz podtestu, aby raport wskazał dane wejściowe, dla których wynik różnił się od oczekiwanego.
W postaci wywoływalnej self.assertRaises(ExpectedError, func, *args, **kwargs) samo wywołuje func z podanymi argumentami. Przekaż func, nie func(...). Asercja przechodzi, gdy wystąpi oczekiwany wyjątek lub wyjątek jego podklasy; brak wyjątku oznacza niepowodzenie, a niedopasowany wyjątek nie jest przechwytywany przez tę asercję. Alternatywnie użyj with self.assertRaises(ExpectedError): i wywołaj funkcję wewnątrz bloku.
Przykłady
import unittest
class ParseTests(unittest.TestCase):
def test_parse(self):
for text, expected in [("12", 13), ("-3", -3)]:
with self.subTest("valid integer", text=text):
self.assertEqual(int(text), expected)
with self.subTest("invalid integer", text="bad"):
self.assertRaises(ValueError, int, "bad")
print("Invalid input rejected")
if __name__ == "__main__":
result = ParseTests("test_parse").run()
tests, failures, errors = result.testsRun, len(result.failures), len(result.errors)
print(f"tests={tests}, failures={failures}, errors={errors}")
# The demonstration succeeds only if it records the deliberate failure.
if (tests, failures, errors) != (1, 1, 0):
raise SystemExit(1)
Wynik
Invalid input rejected tests=1, failures=1, errors=0
Dla `"12"` celowo podano błędne oczekiwanie `13`. Podtest dla `"-3"` przechodzi, a w przypadku `"bad"` komunikat jest wypisywany dopiero po przechwyceniu oczekiwanego `ValueError`. Podsumowanie liczy jedną metodę testową, jedno niepowodzenie i zero błędów. Skrypt kończy się kodem `0`, gdy te liczby są zgodne z oczekiwaniami.
Powiązane lekcje
- Python · Lekcja 37 · Zaawansowany · Wersja: 5
Źródła
- Python 3.12 unittest — TestCase.subTest
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 unittest — TestCase.assertEqual
- Python 3.12 unittest — TestCase.assertRaises
- Python 3.12 unittest — TestCase.run
- Python 3.12 unittest — TestResult.addSubTest
- Python 3.12 unittest — failfast command-line option