CKTIS / Python
Ejecutar pruebas y examinar el resultado de `TextTestRunner.run`
Ejecuta una suite de pruebas o un caso individual y usa el `TestResult` devuelto para crear un resumen propio sin analizar el informe de texto.
Versión: Python 3.12
Sintaxis
runner = unittest.TextTestRunner(stream=report_stream)
result = runner.run(test)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()En Python 3.12, unittest.TextTestRunner.run recibe una instancia de TestSuite o TestCase, ejecuta las pruebas proporcionadas y devuelve un objeto TestResult (TextTestResult de forma predeterminada). Por separado, el ejecutor escribe un informe de texto en el flujo configurado mediante stream, que por defecto es sys.stderr.
result.testsRun cuenta las pruebas iniciadas, no las superadas ni las programadas. result.failures y result.errors son listas de pares (prueba, traza de pila formateada). Una aserción fallida, como self.assertEqual(...), se registra en failures; una excepción inesperada, como un ValueError que no se captura en un método de prueba, se registra en errors. Usa len(...) para contar las entradas de cada lista.
result.wasSuccessful() devuelve True si no se registraron fallos, errores ni éxitos inesperados. Un éxito inesperado se produce cuando supera la prueba un test marcado con @unittest.expectedFailure. Las pruebas omitidas y los fallos esperados no hacen por sí solos que el método devuelva False. No sustituyas este método por una comprobación de solo las dos listas ni interpretes True como prueba de que se ejecutó algún test.
Ejemplos
import io
import unittest
class ArithmeticTests(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("intentional test error")
if __name__ == "__main__":
suite = unittest.TestSuite([
ArithmeticTests("test_pass"),
ArithmeticTests("test_failure"),
ArithmeticTests("test_error"),
])
report_stream = io.StringIO()
result = unittest.TextTestRunner(stream=report_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 pasa, otra falla en una aserción y otra provoca un error. `io.StringIO()` captura el informe habitual del ejecutor, incluido el tiempo transcurrido, así que la consola solo muestra el resumen de cuatro líneas.
Lecciones relacionadas
- Python · Lección 37 · Avanzado · Versión: 5
- Python · Lección 34 · Intermedio · Versión: 3