Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

Testowanie wyjątków za pomocą assertRaises

Użyj `unittest.TestCase.assertRaises` w formie wywołania lub w bloku `with`, aby sprawdzić, czy operacja zgłasza oczekiwany wyjątek.

Wersja: Python 3.12

Składnia

self.assertRaises(exception, callable, *args, **kwds)

with self.assertRaises(exception, msg=None) as cm:
    operation()
# After a matching exception, inspect cm.exception.

W Pythonie 3.12 assertRaises to metoda klasy unittest.TestCase. Przekaż klasę wyjątku, nie jej instancję, lub krotkę klas, jeśli dopuszczasz kilka typów. Pasuje również podklasa wskazanej klasy. Pasujący wyjątek zostaje przechwycony i asercja przechodzi. Brak wyjątku oznacza niepowodzenie asercji. Niepasujący wyjątek nie jest przechwytywany i zwykle jest zgłaszany jako błąd testu.

W formie z obiektem wywoływalnym napisz self.assertRaises(ValueError, parse_port, "0"). Przekaż samo parse_port oraz jego argumenty pozycyjne i nazwane osobno. Nie przekazuj wyniku parse_port("0"): takie wywołanie nastąpiłoby, zanim asercja mogłaby przechwycić wyjątek.

W formie kontekstowej użyj with self.assertRaises(ValueError) as cm: i umieść w bloku tylko operację, która ma zgłosić wyjątek. Inna operacja zgłaszająca ten sam typ mogłaby sprawić, że asercja przejdzie z niewłaściwego powodu. Po bloku cm.exception zawiera przechwyconą instancję. Opcjonalne msg= w tej formie dostarcza komunikat na wypadek niepowodzenia asercji, a nie wzorzec tekstu wyjątku. Aby sprawdzić tekst wyrażeniem regularnym, użyj assertRaisesRegex.

setUp() przygotowuje dane przed każdą metodą testową, nie przed każdym blokiem subTest(). assertEqual sprawdza poprawne wyniki i może też porównać tekst przechwyconego wyjątku. subTest(invalid=invalid) oznacza każdą iterację wartością, która pojawi się w raporcie, jeśli podtest się nie powiedzie.

Przykłady

import io
import unittest


def parse_port(text):
    port = int(text)
    if not 1 <= port <= 65535:
        raise ValueError("port must be between 1 and 65535")
    return port


class PortTests(unittest.TestCase):
    def setUp(self):
        self.default_port = "80"
        self.highest_port = "65535"

    def test_context_form(self):
        self.assertEqual(parse_port(self.default_port), 80)
        self.assertEqual(parse_port(self.highest_port), 65535)

        with self.assertRaises(ValueError) as cm:
            parse_port("0")

        self.assertEqual(str(cm.exception), "port must be between 1 and 65535")

    def test_callable_form(self):
        for invalid, valid, expected in (("0", "1", 1), ("65536", self.highest_port, 65535)):
            with self.subTest(invalid=invalid):
                self.assertEqual(parse_port(valid), expected)
                self.assertRaises(ValueError, parse_port, invalid)


if __name__ == "__main__":
    log = io.StringIO()
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(PortTests)
    result = unittest.TextTestRunner(stream=log).run(suite)
    if not result.wasSuccessful():
        raise SystemExit(log.getvalue())
    print(f"OK ({result.testsRun} tests)")

Wynik

OK (2 tests)

Przykład sprawdza poprawne porty, przechwytuje wyjątek dla `"0"` i porównuje jego tekst. Następnie sprawdza w oznaczonych podtestach, czy `"0"` i `"65536"` zostają odrzucone. Własne podsumowanie liczy dwie metody testowe, a nie iteracje podtestów.

Powiązane lekcje

  • Python · Lekcja 37 · Zaawansowany · Wersja: 5
  • Python · Lekcja 34 · Średniozaawansowany · Wersja: 3

Źródła