Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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