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

CKTIS / Python

unittest.expectedFailure

El decorador marca un fallo esperado en el método de prueba.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

@unittest.expectedFailure

El decorador marca un fallo esperado en el método de prueba.

La excepción SkipTest se trata por separado y se añade a skipped en lugar de expectedFailures. Una aserción fallida u otra excepción ordinaria en su cuerpo se añade a expectedFailures, con 1 fallo esperado y 0 ordinarios en el ejemplo. Si la prueba pasa, se añade a unexpectedSuccesses y wasSuccessful() da False.

Un error de setUp o tearDown sigue siendo un error.

import unittest
class Known(unittest.TestCase):
    @unittest.expectedFailure
    def test_broken(self): raise ValueError('broken')
    @unittest.expectedFailure
    def test_fixed(self): pass
class Setup(Known):
    def setUp(self): raise ValueError('fixture')
r=unittest.TestResult()
Known('test_broken').run(r)
assert len(r.expectedFailures)==1 and r.wasSuccessful()
Known('test_fixed').run(r)
assert len(r.unexpectedSuccesses)==1 and not r.wasSuccessful()
Setup('test_broken').run(r)
assert len(r.errors)==1
class Omit(unittest.TestCase):
    @unittest.expectedFailure
    def test_skip(self): raise unittest.SkipTest('reason')
r=unittest.TestResult()
Omit('test_skip').run(r)
assert len(r.skipped)==1 and not r.expectedFailures

Ejemplos

import unittest
class Check(unittest.TestCase):
    @unittest.expectedFailure
    def test_known(self): self.assertEqual(2, 3)

r = unittest.TestResult()
Check("test_known").run(r)
print(len(r.expectedFailures), len(r.failures))

Resultado

1 0

Un error de setUp o tearDown sigue siendo un error.

Fuentes