Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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