CKTIS / Python
`unittest.TestCase.setUp`: preparare ogni test
Usa `setUp()` per far partire ogni test con dati nuovi. Poi verifica i valori con `assertEqual()` e un’eccezione attesa con `assertRaises()`.
Versione: Python 3.12
Sintassi
import unittest
class ExampleTests(unittest.TestCase):
def setUp(self):
self.items = [10, 20]unittest.TestCase.setUp è un metodo di istanza che unittest chiama automaticamente subito prima di eseguire ciascun metodo di test. Definisci setUp(self) in una sottoclasse di unittest.TestCase e salva su self i dati che fanno parte dell’ambiente di prova (fixture). L’implementazione predefinita non fa nulla.
unittest crea un’istanza distinta di TestCase per ciascun metodo di test. Crea una nuova lista in setUp() invece di condividere una lista modificabile come attributo di classe. Nell’esempio, test_pop modifica la propria lista, mentre test_remove_missing parte da una nuova lista [10, 20]. setUpClass() è un metodo di classe per la preparazione condivisa a livello di classe, non per inizializzare ogni test separatamente.
Le tre chiamate a assertEqual(ottenuto, atteso) verificano l’uguaglianza dei valori, non l’identità degli oggetti: controllano l’elemento restituito, la lista dopo pop() e la lista dopo il tentativo di rimozione non riuscito. Il blocco with self.assertRaises(ValueError): racchiude solo il tentativo di rimuovere il valore assente. Se non viene sollevata alcuna eccezione, l’asserzione fallisce; un’eccezione diversa si propaga. La forma alternativa riceve il metodo da chiamare e il suo argomento: self.assertRaises(ValueError, self.items.remove, 99).
Se setUp() solleva un’eccezione, non vengono eseguiti né il metodo di test né tearDown(). AssertionError conta come fallimento, unittest.SkipTest indica un test saltato e quasi tutte le altre eccezioni contano come errori. Le funzioni di pulizia già registrate con addCleanup() vengono comunque eseguite quando unittest registra un fallimento, un errore o un test saltato durante la preparazione. In Python 3.12, però, se KeyboardInterrupt non viene intercettata in setUp(), l’eccezione si propaga all’esterno di TestCase.run() prima che venga chiamato doCleanups(). Se la preparazione riesce, tearDown() viene eseguito anche se il test fallisce.
Esempi
import unittest
class ListTests(unittest.TestCase):
def setUp(self):
self.items = [10, 20]
def test_pop(self):
removed = self.items.pop()
self.assertEqual(removed, 20)
self.assertEqual(self.items, [10])
def test_remove_missing(self):
with self.assertRaises(ValueError):
self.items.remove(99)
self.assertEqual(self.items, [10, 20])
if __name__ == "__main__":
suite = unittest.defaultTestLoader.loadTestsFromTestCase(ListTests)
result = unittest.TestResult()
suite.run(result)
print(f"Tests run: {result.testsRun}")
print(f"Successful: {result.wasSuccessful()}")
raise SystemExit(0 if result.wasSuccessful() else 1)
Risultato
Tests run: 2 Successful: True
Esegui `python list_tests.py` con Python 3.12. L’output atteso mostra che sono stati eseguiti due test e che la suite è riuscita; lo script non stampa il tempo trascorso.
Lezioni correlate
- Python · Lezione 34 · Intermedio · Versione: 3