Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

Spuštění testů a vyhodnocení výsledku `TextTestRunner.run`

Spusťte sadu testů nebo jednotlivý testovací případ a z vráceného objektu `TestResult` sestavte vlastní souhrn bez rozebírání textového výpisu.

Verze: Python 3.12

Syntaxe

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

V Pythonu 3.12 metoda unittest.TextTestRunner.run přijímá instanci TestSuite nebo TestCase, spustí předané testy a vrátí objekt TestResult (ve výchozím nastavení TextTestResult). Nezávisle na návratové hodnotě zapisuje spouštěč textový výpis do proudu zvoleného parametrem stream; výchozí je sys.stderr.

result.testsRun udává počet zahájených testů, nikoli úspěšných nebo naplánovaných. result.failures a result.errors jsou seznamy dvojic (test, formátovaný výpis zásobníku). Nesplněná aserce, například self.assertEqual(...), se zaznamená do failures; neočekávaná výjimka, například ValueError nezachycená v testovací metodě, do errors. Počet položek v každém seznamu zjistíte pomocí len(...).

result.wasSuccessful() vrátí True, pokud nebyla zaznamenána žádná selhání, chyby ani neočekávané úspěchy. Neočekávaný úspěch nastane, když projde test označený pomocí @unittest.expectedFailure. Přeskočené testy a očekávaná selhání samy o sobě nevedou k False. Nenahrazujte tuto metodu kontrolou pouze obou seznamů a nepovažujte True za důkaz, že se vůbec nějaký test spustil.

Příklady

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()}")

Výsledek

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

Jeden test projde, jeden skončí nesplněnou asercí a jeden vyvolá chybu. `io.StringIO()` zachytí běžný výpis spouštěče včetně doby běhu, takže se na konzoli objeví jen vlastní čtyřřádkový souhrn.

Související lekce

  • Python · Lekce 37 · Pokročilá · Verze: 5
  • Python · Lekce 34 · Středně pokročilá · Verze: 3

Zdroje