CKTIS / Python
unittest: Fehlgeschlagene Assertions und Testfehler
Führe eine Testsuite aus und erstelle mit `testsRun`, `failures` und `errors` eine reproduzierbare Zusammenfassung, ohne den Textbericht auszuwerten.
Version: Python 3.12
Syntax
runner = unittest.TextTestRunner(stream=stream)
result = runner.run(suite)
result.testsRun
result.failures
result.errors
len(result.failures)
len(result.errors)In Python 3.12 führt unittest.TextTestRunner.run(suite) die Testsuite aus und gibt ein unittest.TestResult-Objekt zurück, standardmäßig ein TextTestResult. Lies die Daten aus dem Ergebnisobjekt, statt den Textbericht auszuwerten. result.testsRun zählt die gestarteten Tests, nicht die bestandenen Tests oder die Größe der Suite vor dem Lauf.
Ein fehlgeschlagenes self.assertEqual(...) löst eine Ausnahme vom Typ failureException des Testfalls aus, standardmäßig AssertionError. Wenn unittest eine Ausnahme als Fehlschlag oder Fehler einstuft, landet sie in result.failures, wenn ihr Typ failureException oder eine Unterklasse davon ist, andernfalls in result.errors. Ein unbehandelter ValueError in einer Testmethode gilt daher standardmäßig als Fehler, aber als Fehlschlag, wenn er zur konfigurierten failureException passt. Schlägt die Assertion im Rumpf einer mit @unittest.expectedFailure dekorierten Testmethode fehl und laufen tearDown und die Aufräumfunktionen ohne Probleme durch, wird das Ergebnis stattdessen in result.expectedFailures erfasst. Jeder Eintrag in result.failures oder result.errors besteht aus einem Testobjekt und einem formatierten Traceback als Zeichenkette. Zähle die Einträge mit len(result.failures) und len(result.errors).
Ziehe die beiden Listenlängen nicht von testsRun ab, um bestandene Tests zu zählen: Übersprungene Tests werden separat erfasst, und ein Test kann mehrere Einträge erzeugen, etwa mit subTest. Verwende für das Gesamturteil result.wasSuccessful(): Die Methode liefert auch dann False, wenn ein als erwarteter Fehlschlag markierter Test überraschend besteht.
Beispiele
import io
import unittest
class DemoTests(unittest.TestCase):
def test_pass(self):
self.assertEqual(2 + 2, 4)
def test_failure(self):
self.assertEqual(2 + 2, 5)
def test_error(self):
raise ValueError("unexpected value")
suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
result = unittest.TextTestRunner(stream=io.StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")Ergebnis
testsRun=3 failures=1 errors=1
Ein Test besteht, einer scheitert an einer Assertion und einer löst einen Fehler aus. `io.StringIO()` fängt den Bericht des Testrunners ab, sodass in der Konsole nur die Zeile mit den Anzahlen erscheint.
Zugehörige Lektionen
- Python · Lektion 37 · Fortgeschritten · Version: 5