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
- Python 3.12 unittest — TestResult.testsRun
- Python 3.12 unittest — TextTestRunner.run
- Python 3.12 unittest — TestResult
- Python 3.12 unittest — TestSuite.countTestCases
- Python 3.12 unittest — Class and Module Fixtures
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 io — StringIO