CKTIS / Python
`unittest.TestCase.setUp` : préparer chaque test
Utilisez `setUp()` pour fournir des données neuves à chaque test, puis vérifiez des valeurs avec `assertEqual()` et une exception attendue avec `assertRaises()`.
Version : Python 3.12
Syntaxe
import unittest
class ExampleTests(unittest.TestCase):
def setUp(self):
self.items = [10, 20]unittest.TestCase.setUp est une méthode d’instance que unittest appelle automatiquement juste avant chaque méthode de test exécutée. Définissez setUp(self) dans une sous-classe de unittest.TestCase et stockez sur self les données qui font partie de l’environnement de test (fixture). L’implémentation par défaut ne fait rien.
unittest crée une instance distincte de TestCase pour chaque méthode de test. Créez une nouvelle liste dans setUp() plutôt que de partager une liste modifiable comme attribut de classe. Dans l’exemple, test_pop modifie sa liste, tandis que test_remove_missing démarre avec une nouvelle liste [10, 20]. setUpClass() est une méthode de classe destinée à une préparation commune à la classe, et non à chaque test.
Les trois appels à assertEqual(obtenu, attendu) vérifient l’égalité des valeurs, pas l’identité des objets : ils contrôlent l’élément renvoyé, la liste après pop() et la liste après la tentative de suppression infructueuse. Le bloc with self.assertRaises(ValueError): ne contient que la tentative de suppression de la valeur absente. Si aucune exception n’est levée, l’assertion échoue ; une autre exception se propage. L’autre forme reçoit directement la méthode à appeler et son argument : self.assertRaises(ValueError, self.items.remove, 99).
Si setUp() lève une exception, ni la méthode de test ni tearDown() ne sont exécutées. AssertionError compte comme un échec, unittest.SkipTest indique un test ignoré, et la plupart des autres exceptions comptent comme des erreurs. Les fonctions de nettoyage déjà enregistrées avec addCleanup() sont tout de même exécutées lorsque unittest enregistre un échec, une erreur ou un test ignoré lors de la préparation. Toutefois, dans Python 3.12, si KeyboardInterrupt n’est pas interceptée dans setUp(), l’exception se propage hors de TestCase.run() avant l’appel à doCleanups(). Si la préparation réussit, tearDown() s’exécute même si le test échoue.
Exemples
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)
Résultat
Tests run: 2 Successful: True
Exécutez `python list_tests.py` avec Python 3.12. La sortie attendue indique que deux tests ont été exécutés et que la suite a réussi ; le script n’affiche pas la durée.
Leçons associées
- Python · Leçon 34 · Intermédiaire · Version : 3