CKTIS / Python
TestResult: um relatório de unittest em quatro linhas
Executa um conjunto de testes e usa o `TestResult` devolvido para indicar quantos testes começaram, quantas falhas e erros foram registados e se a execução teve êxito.
Versão: Python 3.12
Sintaxe
result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()Em Python 3.12, unittest.TextTestRunner.run(suite) executa o conjunto de testes e devolve, por omissão, um TextTestResult, uma subclasse de TestResult. Guarda o objeto devolvido para criar um relatório personalizado em vez de analisar o texto produzido pelo executor.
result.testsRun é um número inteiro que conta os testes iniciados, não os testes bem-sucedidos nem os planeados. Um teste ignorado conta se o seu início tiver sido registado. Em contrapartida, pode ser registado um erro na preparação de uma classe de testes sem que nenhum dos seus testes comece.
result.failures e result.errors são listas, não contadores. A primeira regista falhas, como uma asserção assertEqual que não se verifica; a segunda regista erros, como um ValueError inesperado. Cada entrada contém um objeto que identifica o teste e um rasto da pilha de chamadas formatado como texto. Usa len(...) para contar as entradas.
result.wasSuccessful() é um método: chama-o com parênteses. Só devolve True se não houver falhas, erros nem êxitos inesperados registados. Um êxito inesperado ocorre quando um teste marcado com @unittest.expectedFailure passa. Os testes ignorados e as falhas esperadas, por si só, não fazem o método devolver False.
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("demo error")
if __name__ == "__main__":
suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
with io.StringIO() as stream:
result = unittest.TextTestRunner(stream=stream).run(suite)
print(f"Tests run: {result.testsRun}")
print(f"Failures: {len(result.failures)}")
print(f"Errors: {len(result.errors)}")
print(f"Successful: {result.wasSuccessful()}")Resultado
Tests run: 3 Failures: 1 Errors: 1 Successful: False
Um teste passa, outro falha numa asserção e outro lança `ValueError`. O executor escreve o relatório habitual em `io.StringIO`, pelo que só aparecem as quatro linhas personalizadas na consola.
Lições relacionadas
- Python · Lição 34 · Intermédio · Versão: 3