CKTIS / Python
Eseguire i test ed esaminare il risultato di `TextTestRunner.run`
Esegui una suite di test o un singolo caso di test e usa il `TestResult` restituito per creare un riepilogo personalizzato senza analizzare il rapporto testuale.
Versione: Python 3.12
Sintassi
runner = unittest.TextTestRunner(stream=report_stream)
result = runner.run(test)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()In Python 3.12, unittest.TextTestRunner.run accetta un’istanza di TestSuite o TestCase, esegue i test forniti e restituisce un oggetto TestResult (TextTestResult per impostazione predefinita). Separatamente, il runner scrive un rapporto testuale nel flusso impostato con stream, che per impostazione predefinita è sys.stderr.
result.testsRun conta i test avviati, non quelli superati o programmati. result.failures e result.errors sono liste di coppie (test, traceback formattato). Un’asserzione non soddisfatta, come self.assertEqual(...), viene registrata in failures; un’eccezione inattesa, come un ValueError che esce da un metodo di test senza essere intercettato, viene registrata in errors. Usa len(...) per contare le voci di ogni lista.
result.wasSuccessful() restituisce True se non sono stati registrati fallimenti, errori o successi inattesi. Un successo inatteso si verifica quando passa un test marcato con @unittest.expectedFailure. I test saltati e i fallimenti attesi non fanno restituire False da soli. Non sostituire questo metodo con un controllo delle sole due liste e non interpretare True come prova che sia stato eseguito almeno un test.
Esempi
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()}")Risultato
Tests run: 3 Failures: 1 Errors: 1 Successful: False
Un test passa, uno fallisce su un’asserzione e uno genera un errore. `io.StringIO()` cattura il rapporto abituale del runner, incluso il tempo trascorso, così la console mostra soltanto il riepilogo personalizzato di quattro righe.
Lezioni correlate
- Python · Lezione 37 · Avanzato · Versione: 5
- Python · Lezione 34 · Intermedio · Versione: 3