CKTIS / Python
unittest: falhas de asserção e erros nos testes
Executa um conjunto de testes e usa `testsRun`, `failures` e `errors` para criar um resumo determinístico sem analisar o relatório de texto.
Versão: Python 3.12
Sintaxe
runner = unittest.TextTestRunner(stream=stream)
result = runner.run(suite)
result.testsRun
result.failures
result.errors
len(result.failures)
len(result.errors)Em Python 3.12, unittest.TextTestRunner.run(suite) executa o conjunto de testes e devolve um objeto unittest.TestResult, por omissão um TextTestResult. Lê o objeto devolvido em vez de analisares o relatório de texto. result.testsRun conta os testes iniciados, não os que passaram nem o número de testes no conjunto antes da execução.
Se self.assertEqual(...) falhar, lança uma exceção do tipo failureException do caso de teste, que por omissão é AssertionError. Quando unittest classifica uma exceção como falha ou erro, regista-a em result.failures se o seu tipo for failureException ou uma subclasse desse tipo, e em result.errors caso contrário. Um ValueError não tratado num método de teste é, por isso, um erro por omissão, mas é uma falha se corresponder ao failureException configurado. Se a asserção falhar no corpo de um método de teste decorado com @unittest.expectedFailure e tearDown e as funções de limpeza terminarem sem problemas, o resultado é registado em result.expectedFailures em vez de result.failures. Cada entrada de result.failures ou result.errors contém um objeto de teste e uma cadeia de caracteres com o rasto da pilha formatado. Usa len(result.failures) e len(result.errors) para contar as entradas.
Não subtraias os comprimentos das duas listas a testsRun para contar os testes que passaram: os testes ignorados são registados à parte e um teste pode gerar várias entradas, por exemplo com subTest. Para o resultado global, usa result.wasSuccessful(): também devolve False quando um teste marcado como falha esperada passa inesperadamente.
Exemplos
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)}")Resultado
testsRun=3 failures=1 errors=1
Um teste passa, outro falha numa asserção e o terceiro produz um erro. `io.StringIO()` captura o relatório da execução, pelo que a consola só mostra a linha com as contagens.
Lições relacionadas
- Python · Lição 37 · Avançado · Versão: 5