CKTIS / Python
unittest.expectedFailure
Le décorateur signale un échec attendu dans la méthode de test.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
@unittest.expectedFailureLe décorateur signale un échec attendu dans la méthode de test.
L’exception SkipTest est traitée séparément et entre dans skipped au lieu de expectedFailures. Une assertion échouée ou une autre exception ordinaire dans son corps entre dans expectedFailures, soit 1 échec attendu et 0 échec ordinaire ici. Un test devenu réussi entre dans unexpectedSuccesses et wasSuccessful() vaut False.
Une erreur dans setUp ou tearDown reste une erreur.
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
Exemples
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))
Résultat
1 0
Une erreur dans setUp ou tearDown reste une erreur.