Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

unittest.expectedFailure

Il decoratore segnala un fallimento atteso nel metodo di test.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

@unittest.expectedFailure

Il decoratore segnala un fallimento atteso nel metodo di test.

L’eccezione SkipTest ha un trattamento distinto e va in skipped anziché in expectedFailures. Un’asserzione fallita o un’altra eccezione ordinaria nel corpo entra in expectedFailures, con 1 fallimento atteso e 0 ordinari nell’esempio. Un test che passa entra in unexpectedSuccesses e wasSuccessful() dà False.

Un errore in setUp o tearDown rimane un errore.

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

Esempi

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))

Risultato

1 0

Un errore in setUp o tearDown rimane un errore.

Fonti