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.expectedFailureEl 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.