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
- unittest — Unit testing framework: TestCase.assertRaises (Python 3.12)
- unittest — Unit testing framework: TestCase.assertRaisesRegex (Python 3.12)
- unittest — Unit testing framework: TestCase.setUp (Python 3.12)
- unittest — Unit testing framework: TestCase.assertEqual (Python 3.12)
- unittest — Unit testing framework: TestCase.subTest (Python 3.12)
- unittest — Unit testing framework: TextTestRunner (Python 3.12)