CKTIS / Python
Ausnahmen mit assertRaises testen
Mit `unittest.TestCase.assertRaises` prüfst du, ob eine Operation die erwartete Ausnahme auslöst: entweder mit einem aufrufbaren Objekt oder in einem `with`-Block.
Version: Python 3.12
Syntax
self.assertRaises(exception, callable, *args, **kwds)
with self.assertRaises(exception, msg=None) as cm:
operation()
# After a matching exception, inspect cm.exception.In Python 3.12 ist assertRaises eine Methode von unittest.TestCase. Übergib eine Ausnahmeklasse, keine Instanz, oder ein Tupel von Klassen, wenn mehrere Typen zulässig sind. Auch eine Unterklasse einer erwarteten Klasse passt. Eine passende Ausnahme wird abgefangen und die Prüfung ist erfolgreich. Wird keine Ausnahme ausgelöst, schlägt die Prüfung fehl. Eine unpassende Ausnahme wird weitergegeben und in der Regel als Testfehler gemeldet.
Schreibe für die Form mit einem aufrufbaren Objekt self.assertRaises(ValueError, parse_port, "0"). Übergib parse_port selbst und gib seine Positions- und Schlüsselwortargumente separat an. Übergib nicht das Ergebnis von parse_port("0"): Der Aufruf würde stattfinden, bevor die Prüfung die Ausnahme abfangen kann.
Schreibe für die Kontextmanager-Form with self.assertRaises(ValueError) as cm: und setze nur die Operation in den Block, die die Ausnahme auslösen soll. Eine andere Operation, die denselben Typ auslöst, könnte die Prüfung aus dem falschen Grund bestehen lassen. Nach dem Block enthält cm.exception die abgefangene Instanz. Das optionale msg= liefert in dieser Form eine Meldung für eine fehlgeschlagene Prüfung, kein Muster für den Ausnahmetext. Prüfe den Text mit assertRaisesRegex, wenn du einen regulären Ausdruck verwenden willst.
setUp() bereitet die Testdaten vor jeder Testmethode vor, nicht vor jedem subTest()-Block. assertEqual prüft erfolgreiche Ergebnisse und kann auch den Text der abgefangenen Ausnahme vergleichen. subTest(invalid=invalid) versieht jeden Durchlauf mit dem Wert, der bei einem fehlgeschlagenen Subtest im Bericht erscheint.
Beispiele
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)")
Ergebnis
OK (2 tests)
Das Beispiel prüft gültige Ports, fängt die Ausnahme für `"0"` ab und vergleicht ihren Text. Danach prüft es in gekennzeichneten Subtests, dass `"0"` und `"65536"` abgewiesen werden. Die eigene Zusammenfassung zählt die beiden Testmethoden, nicht die Subtest-Durchläufe.
Zugehörige Lektionen
- Python · Lektion 37 · Fortgeschritten · Version: 5
- Python · Lektion 34 · Mittlere Stufe · Version: 3
Quellen
- 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)