CKTIS / Python
TestResult.testsRun: contare i test avviati
Esegui una suite con `unittest.TextTestRunner.run()` e leggi `testsRun`, `failures` ed `errors` dall’oggetto restituito per creare un riepilogo.
Versione: Python 3.12
Sintassi
result = unittest.TextTestRunner().run(suite)
result.testsRun # int
len(result.failures)
len(result.errors)In Python 3.12, unittest.TextTestRunner.run(suite) esegue la suite e restituisce un oggetto risultato. TestResult.testsRun è un attributo intero: al termine della chiamata, leggi result.testsRun senza parentesi. Il contatore standard aumenta quando inizia un caso di test, non quando il caso viene superato. Un caso saltato singolarmente viene contato anche se il corpo del suo metodo non viene eseguito. Le chiamate a subTest() non incrementano il contatore separatamente.
result.failures e result.errors sono liste di voci con traceback formattati. Un’asserzione non soddisfatta, per esempio con assertEqual(), viene registrata in failures; un’eccezione imprevista come RuntimeError viene registrata in errors. Usa len() per contare le voci di ogni lista. Non sottrarre questi conteggi da testsRun per ottenere il numero di test superati: i casi saltati sono registrati a parte in result.skipped e un caso può produrre più voci, per esempio se falliscono più sottotest.
Per contare invece i casi contenuti nella suite, chiama suite.countTestCases() prima di eseguirla. Con failfast=True, l’esecuzione può fermarsi prima che tutti i casi siano avviati. Un errore in setUpClass() può essere registrato in errors anche se nessun caso della classe è stato avviato. Leggi i conteggi dall’oggetto risultato invece di analizzare il resoconto testuale.
Esempi
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 RuntimeError("unexpected error")
@unittest.skip("demonstrate a skipped test")
def test_skip(self):
self.fail("this body is not executed")
suite = unittest.TestSuite(
DemoTests(name)
for name in ("test_pass", "test_failure", "test_error", "test_skip")
)
with io.StringIO() as report:
result = unittest.TextTestRunner(stream=report, failfast=False).run(suite)
print(f"testsRun={result.testsRun}")
print(f"failures={len(result.failures)}")
print(f"errors={len(result.errors)}")
print(f"skipped={len(result.skipped)}")Risultato
testsRun=4 failures=1 errors=1 skipped=1
Un caso viene superato, in un altro fallisce un’asserzione, un altro solleva `RuntimeError` e uno viene saltato. `io.StringIO` cattura il resoconto, quindi la console mostra soltanto i quattro conteggi, senza traceback né tempo trascorso.
Lezioni correlate
- Python · Lezione 37 · Avanzato · Versione: 5
Fonti
- Python 3.12 unittest — TestResult.testsRun
- Python 3.12 unittest — TextTestRunner.run
- Python 3.12 unittest — TestResult
- Python 3.12 unittest — TestSuite.countTestCases
- Python 3.12 unittest — Class and Module Fixtures
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 io — StringIO