CKTIS / Python
unittest: fallimenti delle asserzioni ed errori nei test
Esegui una suite di test e usa `testsRun`, `failures` ed `errors` per ottenere un riepilogo deterministico senza analizzare il resoconto testuale.
Versione: Python 3.12
Sintassi
runner = unittest.TextTestRunner(stream=stream)
result = runner.run(suite)
result.testsRun
result.failures
result.errors
len(result.failures)
len(result.errors)In Python 3.12, unittest.TextTestRunner.run(suite) esegue la suite e restituisce un oggetto unittest.TestResult, per impostazione predefinita un TextTestResult. Leggi l’oggetto restituito invece di analizzare il resoconto testuale. result.testsRun conta i test avviati, non quelli superati né la dimensione della suite prima dell’esecuzione.
Se self.assertEqual(...) fallisce, solleva un’eccezione del tipo failureException del caso di test, che per impostazione predefinita è AssertionError. Quando unittest classifica un’eccezione come fallimento o errore, la registra in result.failures se il suo tipo è failureException o una sua sottoclasse, altrimenti in result.errors. Un ValueError non gestito in un metodo di test è quindi un errore per impostazione predefinita, ma è un fallimento se corrisponde al failureException configurato. Se l’asserzione fallisce nel corpo di un metodo di test decorato con @unittest.expectedFailure e sia tearDown sia le funzioni di pulizia terminano senza problemi, l’esito viene invece registrato in result.expectedFailures. Ogni voce di result.failures o result.errors contiene un oggetto di test e una stringa con il traceback formattato. Usa len(result.failures) e len(result.errors) per contare le voci.
Non sottrarre entrambe le lunghezze da testsRun per contare i test superati: quelli saltati sono registrati a parte e un test può produrre più voci, per esempio con subTest. Usa result.wasSuccessful() per il verdetto complessivo: restituisce False anche quando un test contrassegnato come fallimento atteso viene superato inaspettatamente.
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 ValueError("unexpected value")
suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
result = unittest.TextTestRunner(stream=io.StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")Risultato
testsRun=3 failures=1 errors=1
Un test viene superato, uno fallisce per un’asserzione e uno genera un errore. `io.StringIO()` cattura il resoconto del runner, quindi nella console appare solo la riga con i conteggi.
Lezioni correlate
- Python · Lezione 37 · Avanzato · Versione: 5