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

CKTIS / Python

Probar excepciones con assertRaises

Usa `unittest.TestCase.assertRaises` con un objeto invocable o en un bloque `with` para comprobar que una operación lanza la excepción esperada.

Versión: Python 3.12

Sintaxis

self.assertRaises(exception, callable, *args, **kwds)

with self.assertRaises(exception, msg=None) as cm:
    operation()
# After a matching exception, inspect cm.exception.

En Python 3.12, assertRaises es un método de unittest.TestCase. Pasa una clase de excepción, no una instancia, o una tupla de clases si aceptas varios tipos. Una subclase de una clase esperada también coincide. Si la excepción coincide, se captura y la aserción pasa. Si no se lanza ninguna excepción, la aserción falla. Una excepción que no coincide se propaga y normalmente se notifica como un error de la prueba.

En la forma con un objeto invocable, escribe self.assertRaises(ValueError, parse_port, "0"). Pasa parse_port sin llamarla y proporciona por separado sus argumentos posicionales y por nombre. No pases el resultado de parse_port("0"): esa llamada se ejecutaría antes de que la aserción pudiera capturar la excepción.

En la forma de gestor de contexto, escribe with self.assertRaises(ValueError) as cm: y coloca en el bloque solo la operación que debe lanzar la excepción. Si otra operación lanza el mismo tipo, la aserción podría pasar por la razón equivocada. Después del bloque, cm.exception contiene la instancia capturada. En esta forma, msg= es opcional y proporciona un mensaje para el fallo de la aserción, no un patrón para el texto de la excepción. Para comprobar el texto con una expresión regular, usa assertRaisesRegex.

setUp() prepara los datos antes de cada método de prueba, no antes de cada bloque subTest(). assertEqual comprueba los resultados de los casos válidos y también puede comparar el texto de la excepción capturada. subTest(invalid=invalid) etiqueta cada iteración con el valor que aparecerá en el informe si falla la subprueba.

Ejemplos

import io
import unittest


def parse_port(text):
    port = int(text)
    if not 1 <= port <= 65535:
        raise ValueError("port must be between 1 and 65535")
    return port


class PortTests(unittest.TestCase):
    def setUp(self):
        self.default_port = "80"
        self.highest_port = "65535"

    def test_context_form(self):
        self.assertEqual(parse_port(self.default_port), 80)
        self.assertEqual(parse_port(self.highest_port), 65535)

        with self.assertRaises(ValueError) as cm:
            parse_port("0")

        self.assertEqual(str(cm.exception), "port must be between 1 and 65535")

    def test_callable_form(self):
        for invalid, valid, expected in (("0", "1", 1), ("65536", self.highest_port, 65535)):
            with self.subTest(invalid=invalid):
                self.assertEqual(parse_port(valid), expected)
                self.assertRaises(ValueError, parse_port, invalid)


if __name__ == "__main__":
    log = io.StringIO()
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(PortTests)
    result = unittest.TextTestRunner(stream=log).run(suite)
    if not result.wasSuccessful():
        raise SystemExit(log.getvalue())
    print(f"OK ({result.testsRun} tests)")

Resultado

OK (2 tests)

El ejemplo comprueba puertos válidos, captura la excepción para `"0"` y compara su texto. Después comprueba en subpruebas etiquetadas que se rechazan `"0"` y `"65536"`. El resumen personalizado cuenta los dos métodos de prueba, no las iteraciones de las subpruebas.

Lecciones relacionadas

  • Python · Lección 37 · Avanzado · Versión: 5
  • Python · Lección 34 · Intermedio · Versión: 3

Fuentes