Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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