CKTIS / Python
TestResult: čtyřřádkový přehled výsledků unittest
Spusť sadu testů a z vráceného objektu `TestResult` zjisti počet zahájených testů, zaznamenaných selhání a chyb i to, zda byl běh celkově úspěšný.
Verze: Python 3.12
Syntaxe
result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()V Pythonu 3.12 spustí unittest.TextTestRunner.run(suite) sadu testů a ve výchozím nastavení vrátí objekt TextTestResult, který je podtřídou TestResult. Objekt si ulož a vytvoř z něj vlastní přehled, místo abys zpracovával textový výstup nástroje pro spouštění testů.
result.testsRun je celé číslo udávající počet zahájených testů, nikoli počet úspěšných nebo naplánovaných testů. Přeskočený test se započítá, pokud byl zaznamenán jeho začátek. Chyba při přípravě testovací třídy se naopak může zaznamenat, aniž by se spustil některý z jejích testů.
result.failures a result.errors jsou seznamy, nikoli počitadla. První obsahuje selhání, například nesplněnou kontrolu assertEqual, druhý chyby, například neočekávanou výjimku ValueError. Každá položka obsahuje objekt identifikující test a formátovaný výpis zásobníku volání jako řetězec. Položky spočítáš pomocí len(...).
result.wasSuccessful() je metoda, proto použij závorky. Vrátí True, jen pokud nejsou zaznamenána žádná selhání, chyby ani neočekávané úspěchy. Neočekávaným úspěchem je úspěšný test označený pomocí @unittest.expectedFailure. Přeskočené testy ani očekávaná selhání samy o sobě nevedou k výsledku False.
Příklady
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()}")Výsledek
Tests run: 3 Failures: 1 Errors: 1 Successful: False
Jeden test projde, jeden selže na aserci a jeden vyvolá `ValueError`. Výchozí přehled se zapisuje do `io.StringIO`, takže se v konzoli objeví jen čtyři vlastní řádky.
Související lekce
- Python · Lekce 34 · Středně pokročilá · Verze: 3