WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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