CKTIS / Python
unittest.TestResult.failures — lista de falhas de asserção
unittest.TestResult.failures guarda as falhas de asserção como pares que contêm um objeto de teste e o texto formatado do traceback.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
result.failures
for test, traceback_text in result.failures:
...unittest.TestResult.failures é um atributo de instância, não um método. Contém uma lista de pares (test, traceback_text): um objeto TestCase e uma cadeia de texto com o traceback formatado. Consulte-o no objeto de resultado depois de executar os testes.
Para classificar como falha ou erro uma exceção lançada num método de teste normal, unittest usa o tipo failureException do caso de teste. As exceções desse tipo ou das suas subclasses são adicionadas a failures; as restantes, a errors. O tipo predefinido é AssertionError, que é lançado, por exemplo, quando uma chamada a assertEqual() falha. Já um AssertionError lançado em setUpClass é registado em errors. As falhas esperadas são guardadas separadamente em expectedFailures. Assim, uma lista failures vazia não prova que toda a suite tenha sido bem-sucedida.
O exemplo provoca deliberadamente uma falha. Verifica a estrutura da entrada sem apresentar o traceback, cujos caminhos e números de linha dependem do ficheiro.
Exemplos
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))Resultado
failures: 1 test: __main__.SampleTest.test_total traceback is text: True errors: 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.