CKTIS / Python
unittest.TestResult.failures — elenco degli errori di asserzione
unittest.TestResult.failures memorizza gli errori di asserzione come coppie contenenti un oggetto di test e il testo formattato del traceback.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
result.failures
for test, traceback_text in result.failures:
...unittest.TestResult.failures è un attributo di istanza, non un metodo. Contiene un elenco di coppie (test, traceback_text): un oggetto TestCase e una stringa con il traceback formattato. Leggilo dall’oggetto risultato dopo aver eseguito i test.
Per classificare come fallimento o errore un’eccezione sollevata in un normale metodo di test, unittest usa il tipo failureException del caso di test. Le eccezioni di quel tipo o delle sue sottoclassi finiscono in failures; le altre in errors. Il tipo predefinito è AssertionError, l’eccezione sollevata, ad esempio, quando una chiamata ad assertEqual() fallisce. Un’eccezione AssertionError sollevata in setUpClass finisce invece in errors. I fallimenti attesi vengono memorizzati separatamente in expectedFailures. Un elenco failures vuoto, quindi, non dimostra che l’intera suite sia riuscita.
L’esempio produce intenzionalmente un fallimento. Controlla la struttura della voce senza stampare il traceback, i cui percorsi e numeri di riga dipendono dal file.
Esempi
import unittest
class SampleTest(unittest.TestCase):
def test_total(self):
self.assertEqual(2 + 2, 5)
result = unittest.TestResult()
SampleTest("test_total").run(result)
test, traceback_text = result.failures[0]
print("test:" if False else "failures:", len(result.failures))
print("test:", test.id())
print("traceback is text:", isinstance(traceback_text, str))
print("errors:", len(result.errors))Risultato
failures: 1 test: __main__.SampleTest.test_total traceback is text: True errors: 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.