CKTIS / Python
unittest-Ergebnisse: gestartete Tests, Fehlschläge und Fehler
Führe eine Testsuite aus und zähle anhand des zurückgegebenen Ergebnisses gestartete Testfälle, fehlgeschlagene Assertions und unerwartete Ausnahmen getrennt.
Version: Python 3.12
Syntax
result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)In Python 3.12 führt unittest.TextTestRunner.run(suite) die Testsuite aus und gibt ein TestResult-Objekt zurück. result.testsRun zählt gestartete Testfälle, nicht die bei der Testsuche gefundenen oder nur die bestandenen Fälle. Auch ein nach dem Start übersprungener Fall kann mitgezählt werden.
result.failures erfasst Fehlschläge wie eine nicht erfüllte Prüfung mit assertEqual(). Assertions von TestCase melden einen Fehlschlag mit failureException, standardmäßig AssertionError. result.errors erfasst unerwartete Ausnahmen wie einen nicht abgefangenen RuntimeError in einer Testmethode. Jeder Eintrag in beiden Listen ist ein Paar aus Testobjekt und Zeichenkette mit formatiertem Traceback.
Mit len(result.failures) und len(result.errors) zählst du die Einträge, ohne den Textbericht auszuwerten. Ziehe diese Zahlen nicht von testsRun ab, um bestandene Tests zu zählen: Tests können übersprungen werden, und ein Testfall kann mehrere fehlschlagende Untertests enthalten. Das Gesamtergebnis prüfst du mit result.wasSuccessful(), das auch bei einem unerwarteten Erfolg False zurückgibt.
Beispiele
import unittest
from io import StringIO
class SummaryTests(unittest.TestCase):
def test_pass(self):
self.assertEqual(1 + 1, 2)
def test_failure(self):
self.assertEqual(1 + 1, 3)
def test_error(self):
raise RuntimeError("unexpected problem")
suite = unittest.TestSuite([
SummaryTests("test_pass"),
SummaryTests("test_failure"),
SummaryTests("test_error"),
])
result = unittest.TextTestRunner(stream=StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")Ergebnis
testsRun=3 failures=1 errors=1
Ein Testfall besteht, bei einem schlägt eine Assertion fehl und einer löst `RuntimeError` aus. `StringIO` fängt den Bericht des Test-Runners ab, sodass auf der Konsole nur die Zeile mit den Zählerständen erscheint.
Zugehörige Lektionen
- Python · Lektion 37 · Fortgeschritten · Version: 5