CKTIS / Python
Sous-tests unittest : égalité et exceptions attendues
Vérifiez plusieurs entrées dans une seule méthode de test, identifiez les sous-tests en échec et distinguez une assertion d’égalité d’une vérification d’exception.
Version : Python 3.12
Syntaxe
with self.subTest("case label", value=value):
self.assertEqual(actual, expected)
with self.subTest(value=value):
self.assertRaises(ExpectedError, func, *args, **kwargs)
with self.assertRaises(ExpectedError):
func(*args, **kwargs)Dans Python 3.12, unittest.TestCase.subTest renvoie un gestionnaire de contexte. Utilisez with self.subTest("libellé", value=value): pour délimiter un sous-test, par exemple une itération de boucle. Le message facultatif msg et les arguments nommés **params identifient le sous-test dans le rapport d’échec ; ils ne sont pas transmis à la fonction testée.
Sans failfast, une assertion en échec interrompt le bloc with en cours, mais la méthode de test reprend après ce bloc et peut exécuter les sous-tests suivants. Les sous-tests ne sont pas des méthodes de test distinctes et n’exécutent pas setUp() ni tearDown() séparément. Avec failfast, ne supposez pas que les sous-tests suivants seront exécutés.
self.assertEqual(actual, expected) vérifie l’égalité des valeurs (==), pas l’identité des objets (is). Si les valeurs diffèrent, l’assertion échoue. Placez-la dans le sous-test pour que le rapport identifie l’entrée ayant produit le résultat inattendu.
Dans la forme avec un objet appelable, self.assertRaises(ExpectedError, func, *args, **kwargs) appelle func avec les arguments fournis. Passez func, et non func(...). L’assertion réussit si l’exception attendue ou une sous-classe est levée, échoue si aucune exception n’est levée et laisse se propager toute exception qui ne correspond pas. Vous pouvez aussi utiliser with self.assertRaises(ExpectedError): et appeler la fonction dans le bloc.
Exemples
import unittest
class ParseTests(unittest.TestCase):
def test_parse(self):
for text, expected in [("12", 13), ("-3", -3)]:
with self.subTest("valid integer", text=text):
self.assertEqual(int(text), expected)
with self.subTest("invalid integer", text="bad"):
self.assertRaises(ValueError, int, "bad")
print("Invalid input rejected")
if __name__ == "__main__":
result = ParseTests("test_parse").run()
tests, failures, errors = result.testsRun, len(result.failures), len(result.errors)
print(f"tests={tests}, failures={failures}, errors={errors}")
# The demonstration succeeds only if it records the deliberate failure.
if (tests, failures, errors) != (1, 1, 0):
raise SystemExit(1)
Résultat
Invalid input rejected tests=1, failures=1, errors=0
La valeur attendue `13` pour `"12"` est volontairement erronée. Le sous-test pour `"-3"` réussit, et le cas `"bad"` n’affiche son message qu’après l’interception du `ValueError` attendu. Le récapitulatif compte une méthode de test, un échec et zéro erreur. Le script se termine avec le code de sortie `0` si les compteurs correspondent à ces valeurs.
Leçons associées
- Python · Leçon 37 · Avancé · Version : 5
Sources
- Python 3.12 unittest — TestCase.subTest
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 unittest — TestCase.assertEqual
- Python 3.12 unittest — TestCase.assertRaises
- Python 3.12 unittest — TestCase.run
- Python 3.12 unittest — TestResult.addSubTest
- Python 3.12 unittest — failfast command-line option