WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Tests mit `TextTestRunner.run` ausführen und das Ergebnis auswerten

Führe eine Testsuite oder einen einzelnen Testfall aus und erstelle aus dem zurückgegebenen `TestResult` eine eigene Zusammenfassung, ohne den Textbericht auszuwerten.

Version: Python 3.12

Syntax

runner = unittest.TextTestRunner(stream=report_stream)
result = runner.run(test)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()

In Python 3.12 nimmt unittest.TextTestRunner.run eine Instanz von TestSuite oder TestCase entgegen, führt die übergebenen Tests aus und gibt ein TestResult-Objekt zurück (standardmäßig TextTestResult). Unabhängig davon schreibt der Runner einen Textbericht in den über stream gewählten Ausgabestrom; standardmäßig ist das sys.stderr.

result.testsRun zählt die gestarteten Tests, nicht die bestandenen oder eingeplanten. result.failures und result.errors sind Listen mit Paaren der Form (Test, formatierter Traceback). Eine fehlgeschlagene Assertion wie self.assertEqual(...) landet in failures; eine unerwartete Ausnahme wie ein nicht abgefangener ValueError aus einer Testmethode landet in errors. Mit len(...) zählst du die Einträge jeder Liste.

result.wasSuccessful() gibt True zurück, wenn keine fehlgeschlagenen Tests, Fehler oder unerwarteten Erfolge aufgezeichnet wurden. Ein unerwarteter Erfolg liegt vor, wenn ein mit @unittest.expectedFailure markierter Test besteht. Übersprungene Tests und erwartete Fehlschläge führen für sich genommen nicht zu False. Prüfe nicht nur die beiden Listen anstelle dieser Methode und werte True nicht als Beleg dafür, dass überhaupt Tests ausgeführt wurden.

Beispiele

import io
import unittest


class ArithmeticTests(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("intentional test error")


if __name__ == "__main__":
    suite = unittest.TestSuite([
        ArithmeticTests("test_pass"),
        ArithmeticTests("test_failure"),
        ArithmeticTests("test_error"),
    ])
    report_stream = io.StringIO()
    result = unittest.TextTestRunner(stream=report_stream).run(suite)
    print(f"Tests run: {result.testsRun}")
    print(f"Failures: {len(result.failures)}")
    print(f"Errors: {len(result.errors)}")
    print(f"Successful: {result.wasSuccessful()}")

Ergebnis

Tests run: 3
Failures: 1
Errors: 1
Successful: False

Ein Test besteht, bei einem schlägt eine Assertion fehl und einer löst einen Fehler aus. `io.StringIO()` fängt den üblichen Bericht des Runners einschließlich der Laufzeit ab, sodass auf der Konsole nur die eigene vierzeilige Zusammenfassung erscheint.

Zugehörige Lektionen

  • Python · Lektion 37 · Fortgeschritten · Version: 5
  • Python · Lektion 34 · Mittlere Stufe · Version: 3

Quellen