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

CKTIS / Python

Subpruebas de unittest: igualdad y excepciones esperadas

Comprueba varias entradas en un método de prueba, identifica las subpruebas que fallan y distingue la igualdad de valores de una comprobación de excepciones.

Versión: Python 3.12

Sintaxis

with self.subTest("case label", value=value):
    self.assertEqual(actual, expected)

with self.subTest(value=value):
    self.assertRaises(ExpectedError, func, *args, **kwargs)

with self.assertRaises(ExpectedError):
    func(*args, **kwargs)

En Python 3.12, unittest.TestCase.subTest devuelve un gestor de contexto. Usa with self.subTest("etiqueta", value=value): para delimitar una subprueba, por ejemplo una iteración de un bucle. El mensaje opcional msg y los argumentos con nombre **params identifican la subprueba en el informe de fallos; no se pasan a la función que se está probando.

Sin failfast, una aserción fallida interrumpe el bloque with actual, pero el método de prueba continúa después del bloque y puede ejecutar las subpruebas siguientes. Las subpruebas no son métodos de prueba independientes y no ejecutan setUp() ni tearDown() por separado. Con failfast, no des por hecho que se ejecutarán las subpruebas posteriores.

self.assertEqual(actual, expected) comprueba la igualdad de valores (==), no la identidad de objetos (is). Si los valores no son iguales, la aserción falla. Colócala dentro de la subprueba para que el informe identifique la entrada que produjo el resultado inesperado.

En la forma con un objeto invocable, self.assertRaises(ExpectedError, func, *args, **kwargs) llama a func con los argumentos proporcionados. Pasa func, no func(...). La aserción se cumple si se lanza la excepción esperada o una subclase, falla si no se lanza ninguna y deja que se propague una excepción que no coincida. También puedes usar with self.assertRaises(ExpectedError): y llamar a la función dentro del bloque.

Ejemplos

import unittest


class ParseTests(unittest.TestCase):
    def test_parse(self):
        for text, expected in [("12", 13), ("-3", -3)]:
            with self.subTest("valid integer", text=text):
                self.assertEqual(int(text), expected)

        with self.subTest("invalid integer", text="bad"):
            self.assertRaises(ValueError, int, "bad")
            print("Invalid input rejected")


if __name__ == "__main__":
    result = ParseTests("test_parse").run()
    tests, failures, errors = result.testsRun, len(result.failures), len(result.errors)
    print(f"tests={tests}, failures={failures}, errors={errors}")
    # The demonstration succeeds only if it records the deliberate failure.
    if (tests, failures, errors) != (1, 1, 0):
        raise SystemExit(1)

Resultado

Invalid input rejected
tests=1, failures=1, errors=0

El valor esperado `13` para `"12"` es incorrecto a propósito. La subprueba de `"-3"` pasa, y el caso `"bad"` solo imprime su mensaje tras capturar el `ValueError` esperado. El resumen cuenta un método de prueba, un fallo y cero errores. El script termina con el código de salida `0` si los recuentos coinciden con esos valores.

Lecciones relacionadas

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

Fuentes