CKTIS / Python
Subtests in unittest: Gleichheit und erwartete Ausnahmen
Prüfe mehrere Eingaben in einer Testmethode, kennzeichne fehlgeschlagene Subtests und unterscheide Gleichheitsprüfungen von Prüfungen auf erwartete Ausnahmen.
Version: Python 3.12
Syntax
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)In Python 3.12 gibt unittest.TestCase.subTest einen Kontextmanager zurück. Mit with self.subTest("Bezeichnung", value=value): markierst du einen Block als Subtest, etwa einen Schleifendurchlauf. Die optionale Meldung msg und die Schlüsselwortargumente **params identifizieren den Subtest im Fehlerbericht; sie werden nicht an die geprüfte Funktion übergeben.
Ohne failfast beendet eine fehlgeschlagene Assertion den aktuellen with-Block. Die Testmethode läuft danach weiter und kann weitere Subtests ausführen. Subtests sind keine eigenen Testmethoden und führen setUp() und tearDown() nicht separat aus. Mit failfast solltest du nicht davon ausgehen, dass spätere Subtests ausgeführt werden.
self.assertEqual(actual, expected) prüft Wertgleichheit (==), nicht Objektidentität (is). Sind die Werte ungleich, schlägt die Assertion fehl. Setze sie in den Subtest, damit der Bericht die Eingabe mit dem unerwarteten Ergebnis erkennen lässt.
In der Aufrufform ruft self.assertRaises(ExpectedError, func, *args, **kwargs) die Funktion func mit den angegebenen Argumenten auf. Übergib func, nicht func(...). Die Prüfung ist erfolgreich, wenn die erwartete Ausnahme oder eine Unterklasse ausgelöst wird. Ohne Ausnahme schlägt sie fehl; eine nicht passende Ausnahme wird weitergereicht. Alternativ kannst du with self.assertRaises(ExpectedError): verwenden und die Funktion im Block aufrufen.
Beispiele
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)
Ergebnis
Invalid input rejected tests=1, failures=1, errors=0
Der Erwartungswert `13` für `"12"` ist absichtlich falsch. Der Subtest für `"-3"` besteht, und der Fall `"bad"` gibt seine Meldung erst aus, nachdem der erwartete `ValueError` abgefangen wurde. Die Zusammenfassung zählt eine Testmethode, eine fehlgeschlagene Prüfung und null Fehler. Stimmen die Zahlen mit diesen Erwartungen überein, endet das Skript mit Exitstatus `0`.
Zugehörige Lektionen
- Python · Lektion 37 · Fortgeschritten · Version: 5
Quellen
- 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