Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Risultati di unittest: test avviati, fallimenti ed errori

Esegui una suite di test e usa il risultato restituito per contare separatamente i casi avviati, le asserzioni fallite e le eccezioni inattese.

Versione: Python 3.12

Sintassi

result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)

In Python 3.12, unittest.TextTestRunner.run(suite) esegue la suite e restituisce un oggetto TestResult. result.testsRun conta i casi di test avviati, non quelli individuati durante la ricerca né solo quelli superati. Anche un caso saltato dopo l’avvio può essere contato.

result.failures registra fallimenti come quello di un controllo con assertEqual(). Le asserzioni di TestCase segnalano un fallimento con failureException, che per impostazione predefinita è AssertionError. result.errors registra eccezioni inattese, come un RuntimeError non intercettato in un metodo di test. Ogni voce delle due liste è una coppia formata dall’oggetto di test e da una stringa con il traceback formattato.

Usa len(result.failures) e len(result.errors) per contare le voci senza analizzare il resoconto testuale. Non sottrarre questi conteggi da testsRun per calcolare quanti test sono stati superati: alcuni possono essere saltati e un singolo caso può avere più sottotest falliti. Per l’esito complessivo, usa result.wasSuccessful(), che restituisce False anche in caso di successo inatteso.

Esempi

import unittest
from io import StringIO


class SummaryTests(unittest.TestCase):
    def test_pass(self):
        self.assertEqual(1 + 1, 2)

    def test_failure(self):
        self.assertEqual(1 + 1, 3)

    def test_error(self):
        raise RuntimeError("unexpected problem")


suite = unittest.TestSuite([
    SummaryTests("test_pass"),
    SummaryTests("test_failure"),
    SummaryTests("test_error"),
])
result = unittest.TextTestRunner(stream=StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")

Risultato

testsRun=3 failures=1 errors=1

Un caso viene superato, uno fallisce su un’asserzione e uno solleva `RuntimeError`. `StringIO` cattura il resoconto del runner, quindi sulla console compare solo la riga con i conteggi.

Lezioni correlate

  • Python · Lezione 37 · Avanzato · Versione: 5

Fonti