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

CKTIS / Python

unittest: fallos de aserción y errores de prueba

Ejecuta una suite de pruebas y usa `testsRun`, `failures` y `errors` para generar un resumen determinista sin analizar el informe de texto.

Versión: Python 3.12

Sintaxis

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

En Python 3.12, unittest.TextTestRunner.run(suite) ejecuta la suite y devuelve un objeto unittest.TestResult, que por defecto es un TextTestResult. Lee el objeto devuelto en lugar de analizar el informe de texto. result.testsRun cuenta las pruebas iniciadas, no las superadas ni el tamaño de la suite antes de ejecutarla.

Si self.assertEqual(...) falla, lanza una excepción del tipo failureException del caso de prueba, que por defecto es AssertionError. Cuando unittest clasifica una excepción como fallo o error, la registra en result.failures si su tipo es failureException o una subclase de ese tipo, y en result.errors en caso contrario. Por tanto, un ValueError no capturado en un método de prueba es un error por defecto, pero se considera un fallo si coincide con el failureException configurado. Si la aserción falla en el cuerpo de un método de prueba decorado con @unittest.expectedFailure y tanto tearDown como las funciones de limpieza terminan sin problemas, el resultado se registra en result.expectedFailures en lugar de result.failures. Cada entrada de result.failures o result.errors contiene un objeto de prueba y una cadena con la traza de pila formateada. Usa len(result.failures) y len(result.errors) para contar las entradas.

No restes ambas longitudes de testsRun para contar las pruebas superadas: las omitidas se registran por separado y una prueba puede generar varias entradas, por ejemplo con subTest. Usa result.wasSuccessful() para obtener el veredicto global: también devuelve False cuando una prueba marcada como fallo esperado se supera inesperadamente.

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


suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
result = unittest.TextTestRunner(stream=io.StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")

Resultado

testsRun=3 failures=1 errors=1

Una prueba se supera, otra falla en una aserción y la tercera produce un error. `io.StringIO()` captura el informe del ejecutor, de modo que la consola solo muestra la línea con los recuentos.

Lecciones relacionadas

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

Fuentes