Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

TestResult.testsRun: contar os testes iniciados

Execute uma bateria de testes com `unittest.TextTestRunner.run()` e leia `testsRun`, `failures` e `errors` no objeto devolvido para criar um resumo.

Versão: Python 3.12

Sintaxe

result = unittest.TextTestRunner().run(suite)
result.testsRun  # int
len(result.failures)
len(result.errors)

Em Python 3.12, unittest.TextTestRunner.run(suite) executa a bateria de testes e devolve um objeto de resultado. TestResult.testsRun é um atributo inteiro: quando a chamada terminar, leia result.testsRun sem parênteses. O contador predefinido aumenta quando começa o processamento de um caso de teste, não quando o teste é bem-sucedido. Um caso ignorado individualmente conta mesmo que o corpo do método não seja executado. As chamadas a subTest() não aumentam o contador separadamente.

result.failures e result.errors são listas de registos com rastreios de pilha formatados. Uma asserção que falhe, por exemplo com assertEqual(), fica em failures; uma exceção inesperada como RuntimeError fica em errors. Use len() para contar os registos de cada lista. Não subtraia esses valores de testsRun para calcular quantos testes passaram: os casos ignorados são registados à parte em result.skipped e um caso pode gerar vários registos, por exemplo se falharem vários subtestes.

Para contar os casos que a bateria contém, chame suite.countTestCases() antes de a executar. Com failfast=True, a execução pode parar antes de todos os casos começarem. Um erro em setUpClass() pode ser registado em errors mesmo que nenhum caso dessa classe tenha começado. Leia as contagens no objeto de resultado em vez de analisar o relatório textual.

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 RuntimeError("unexpected error")

    @unittest.skip("demonstrate a skipped test")
    def test_skip(self):
        self.fail("this body is not executed")


suite = unittest.TestSuite(
    DemoTests(name)
    for name in ("test_pass", "test_failure", "test_error", "test_skip")
)
with io.StringIO() as report:
    result = unittest.TextTestRunner(stream=report, failfast=False).run(suite)

print(f"testsRun={result.testsRun}")
print(f"failures={len(result.failures)}")
print(f"errors={len(result.errors)}")
print(f"skipped={len(result.skipped)}")

Resultado

testsRun=4
failures=1
errors=1
skipped=1

Um caso passa, outro falha numa asserção, outro lança `RuntimeError` e outro é ignorado. `io.StringIO` captura o relatório, pelo que a consola apresenta apenas as quatro contagens, sem rastreios de pilha nem tempo decorrido.

Lições relacionadas

  • Python · Lição 37 · Avançado · Versão: 5

Fontes