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

CKTIS / Python

assertEqual en unittest: comparar el resultado con el valor esperado

Compara el resultado con el valor esperado mediante `assertEqual`, prepara los datos con `setUp` y comprueba distintas entradas y excepciones.

Versión: Python 3.12

Sintaxis

self.assertEqual(actual, expected, msg=None)

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

En Python 3.12, assertEqual es un método de unittest.TestCase. En self.assertEqual(actual, expected), pasa primero el resultado y luego el valor esperado. El método comprueba la igualdad (==), no la identidad (is). Si los valores son distintos, la aserción falla; puedes añadir contexto con el argumento opcional msg.

Cuando ambos operandos son exactamente del mismo tipo, assertEqual puede usar una comparación específica de ese tipo para ofrecer un mensaje de fallo más informativo. Esto se aplica a list, tuple, dict, set, frozenset, str y a los tipos registrados con addTypeEqualityFunc(). Dos valores pueden ser iguales aunque tengan tipos distintos.

setUp() prepara los datos antes de cada método de prueba, no antes de cada subprueba. En un bucle, with self.subTest(text=text): identifica el caso para que el informe de fallo indique la entrada. Con failfast desactivado, el fallo de una aserción en una subprueba no impide ejecutar las iteraciones siguientes.

Usa assertRaises para comprobar excepciones. Ejecuta la operación dentro del bloque with self.assertRaises(ValueError):. En la forma self.assertRaises(ValueError, int, text), pasa la función sin llamarla y proporciona su argumento por separado. La excepción esperada o una subclase satisface la aserción; si no hay excepción, falla, y si se produce otra, esta se propaga.

Ejemplos

import io
import unittest


class IntConversionTests(unittest.TestCase):
    def setUp(self):
        self.inputs = ('0', '7', '-3', 'not a number')

    def test_direct(self):
        self.assertEqual(int(self.inputs[0]), 0)
        self.assertEqual(int(self.inputs[1]), 7)
        self.assertEqual(int(self.inputs[2]), -3)
        with self.assertRaises(ValueError):
            int(self.inputs[3])

    def test_subtests(self):
        for text, expected in zip(self.inputs[:3], (0, 7, -3)):
            with self.subTest(text=text):
                self.assertEqual(int(text), expected)
        self.assertRaises(ValueError, int, self.inputs[3])


if __name__ == '__main__':
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(IntConversionTests)
    report = io.StringIO()
    result = unittest.TextTestRunner(stream=report).run(suite)
    if not result.wasSuccessful():
        raise SystemExit(report.getvalue())
    print(f'{result.testsRun} tests passed')

Resultado

2 tests passed

`test_direct` hace tres comparaciones directas y comprueba la excepción con un bloque `with`. `test_subtests` usa las mismas entradas en subpruebas identificadas y pasa la función a `assertRaises`. El `2` cuenta los métodos de prueba, no las subpruebas.

Lecciones relacionadas

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

Fuentes