Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

TestResult.testsRun: contar las pruebas iniciadas

Ejecuta una suite con `unittest.TextTestRunner.run()` y consulta `testsRun`, `failures` y `errors` en el objeto devuelto para crear un resumen.

Versión: Python 3.12

Sintaxis

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

En Python 3.12, unittest.TextTestRunner.run(suite) ejecuta la suite y devuelve un objeto de resultado. TestResult.testsRun es un atributo entero: cuando termine la llamada, lee result.testsRun sin paréntesis. El contador estándar aumenta al iniciarse un caso de prueba, no al superarlo. Un caso omitido de forma individual cuenta aunque no se ejecute el cuerpo de su método. Las llamadas a subTest() no incrementan el contador por separado.

result.failures y result.errors son listas de registros que incluyen trazas de pila formateadas. Una aserción fallida, como una comprobación con assertEqual(), se registra en failures; una excepción inesperada como RuntimeError se registra en errors. Usa len() para contar los registros de cada lista. No restes esos valores de testsRun para calcular cuántas pruebas se superaron: los casos omitidos se registran por separado en result.skipped y un caso puede generar varios registros, por ejemplo si fallan varias subpruebas.

Si lo que quieres es contar los casos de la suite, llama a suite.countTestCases() antes de ejecutarla. Con failfast=True, la ejecución puede detenerse antes de que se inicien todos los casos. Un error en setUpClass() puede aparecer en errors aunque no se haya iniciado ningún caso de esa clase. Lee los recuentos del objeto de resultado en vez de analizar el informe de texto.

Ejemplos

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

Un caso se supera, otro falla en una aserción, otro lanza `RuntimeError` y otro se omite. `io.StringIO` captura el informe de ejecución, así que la consola solo muestra los cuatro recuentos, sin trazas ni tiempo transcurrido.

Lecciones relacionadas

  • Python · Lección 37 · Avanzado · Versión: 5

Fuentes