CKTIS / Python
Resultados de unittest: testes iniciados, falhas e erros
Executa uma suite de testes e usa o resultado devolvido para contar separadamente os casos iniciados, as falhas de asserção e as exceções inesperadas.
Versão: Python 3.12
Sintaxe
result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)Em Python 3.12, unittest.TextTestRunner.run(suite) executa a suite e devolve um objeto TestResult. result.testsRun conta os casos de teste iniciados, não os encontrados durante a descoberta nem apenas os que passaram. Um caso ignorado depois de iniciado também pode entrar na contagem.
result.failures regista falhas, como a de uma verificação com assertEqual(). As asserções de TestCase assinalam uma falha com failureException, que por omissão é AssertionError. result.errors regista exceções inesperadas, como um RuntimeError não tratado num método de teste. Cada entrada das duas listas é um par formado pelo objeto de teste e por uma cadeia de caracteres com o traceback formatado.
Usa len(result.failures) e len(result.errors) para contar as entradas sem analisar o relatório em texto. Não subtraias esses valores de testsRun para calcular quantos testes passaram: alguns podem ser ignorados e um caso pode ter vários subtestes que falham. Para verificar o resultado global, usa result.wasSuccessful(), que também devolve False se houver um sucesso inesperado.
Exemplos
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)}")Resultado
testsRun=3 failures=1 errors=1
Um caso passa, outro falha numa asserção e outro lança `RuntimeError`. `StringIO` captura o relatório do executor de testes, pelo que a consola mostra apenas a linha com as contagens.
Lições relacionadas
- Python · Lição 37 · Avançado · Versão: 5