WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

TestResult: ein vierzeiliger unittest-Bericht

Führe eine Testsuite aus und verwende das zurückgegebene `TestResult`, um die Anzahl gestarteter Tests, Fehlschläge und Fehler sowie den Gesamterfolg auszugeben.

Version: Python 3.12

Syntax

result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()

In Python 3.12 führt unittest.TextTestRunner.run(suite) die Testsuite aus und gibt standardmäßig ein TextTestResult zurück, eine Unterklasse von TestResult. Verwende dieses Objekt für einen eigenen Bericht, statt die Textausgabe des Testläufers auszuwerten.

result.testsRun ist eine Ganzzahl und zählt gestartete Tests, nicht bestandene oder eingeplante Tests. Ein übersprungener Test zählt mit, wenn sein Start erfasst wurde. Ein Fehler bei der Vorbereitung einer Testklasse kann dagegen erfasst werden, ohne dass ein Test dieser Klasse startet.

result.failures und result.errors sind Listen, keine Zähler. Die erste enthält Fehlschläge wie eine fehlgeschlagene assertEqual-Prüfung, die zweite Fehler wie einen unerwarteten ValueError. Jeder Eintrag besteht aus einem Objekt, das den Test identifiziert, und einem formatierten Traceback als Zeichenkette. Mit len(...) zählst du die Einträge.

result.wasSuccessful() ist eine Methode und wird mit Klammern aufgerufen. Sie liefert nur dann True, wenn keine Fehlschläge, Fehler oder unerwarteten Erfolge erfasst wurden. Unerwartete Erfolge sind bestandene Tests, die mit @unittest.expectedFailure markiert sind. Übersprungene Tests und erwartete Fehlschläge führen für sich genommen nicht zu False.

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("demo error")


if __name__ == "__main__":
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
    with io.StringIO() as stream:
        result = unittest.TextTestRunner(stream=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, einer scheitert an einer Assertion, und einer löst `ValueError` aus. Der Standardbericht landet in `io.StringIO`, sodass auf der Konsole nur die vier eigenen Zeilen erscheinen.

Zugehörige Lektionen

  • Python · Lektion 34 · Mittlere Stufe · Version: 3

Quellen