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

CKTIS / Python

TestResult: un informe de unittest en cuatro líneas

Ejecuta una suite de pruebas y usa el `TestResult` devuelto para indicar cuántas pruebas se iniciaron, cuántos fallos y errores se registraron y si la ejecución fue satisfactoria.

Versión: Python 3.12

Sintaxis

result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()

En Python 3.12, unittest.TextTestRunner.run(suite) ejecuta la suite y devuelve por defecto un TextTestResult, una subclase de TestResult. Guarda el objeto devuelto para generar tu propio informe en lugar de analizar el texto que escribe el ejecutor.

result.testsRun es un entero que cuenta las pruebas iniciadas, no las superadas ni las programadas. Una prueba omitida cuenta si se registró su inicio. En cambio, puede registrarse un error al preparar una clase de pruebas sin que se inicie ninguna prueba de esa clase.

result.failures y result.errors son listas, no contadores. La primera recoge fallos, como una comprobación assertEqual que no se cumple; la segunda recoge errores, como un ValueError inesperado. Cada entrada contiene un objeto que identifica la prueba y una traza de pila formateada como cadena. Usa len(...) para contar las entradas.

result.wasSuccessful() es un método: llámalo con paréntesis. Solo devuelve True si no hay fallos, errores ni éxitos inesperados registrados. Un éxito inesperado es una prueba que se supera pese a estar marcada con @unittest.expectedFailure. Las omisiones y los fallos esperados no hacen que devuelva False por sí solos.

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 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

Una prueba se supera, otra falla en una aserción y otra lanza `ValueError`. El ejecutor escribe su informe habitual en `io.StringIO`, así que en la consola solo aparecen las cuatro líneas personalizadas.

Lecciones relacionadas

  • Python · Lección 34 · Intermedio · Versión: 3

Fuentes