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

CKTIS / Python

assertEqual dans unittest : comparer le résultat à la valeur attendue

Comparez le résultat à la valeur attendue avec `assertEqual`, préparez les données avec `setUp` et testez plusieurs entrées ainsi que les exceptions.

Version : Python 3.12

Syntaxe

self.assertEqual(actual, expected, msg=None)

with self.subTest(label=value):
    self.assertEqual(actual, expected)

En Python 3.12, assertEqual est une méthode de unittest.TestCase. Dans self.assertEqual(actual, expected), passez d’abord le résultat, puis la valeur attendue. La méthode vérifie l’égalité (==), pas l’identité (is). Si les valeurs diffèrent, l’assertion échoue ; l’argument facultatif msg permet d’ajouter du contexte.

Si les deux opérandes sont exactement du même type, assertEqual peut utiliser une comparaison propre à ce type pour produire un message d’échec plus précis. Cela vaut pour list, tuple, dict, set, frozenset, str et les types enregistrés avec addTypeEqualityFunc(). Deux valeurs peuvent être égales sans être du même type.

setUp() prépare les données avant chaque méthode de test, et non avant chaque sous-test. Dans une boucle, with self.subTest(text=text): identifie le cas pour que le rapport d’échec indique l’entrée testée. Si failfast est désactivé, l’échec d’une assertion dans un sous-test n’empêche pas les itérations suivantes.

Pour vérifier les exceptions, utilisez assertRaises. Exécutez l’opération dans le bloc with self.assertRaises(ValueError):. Dans la forme self.assertRaises(ValueError, int, text), passez la fonction sans l’appeler, puis son argument séparément. L’exception attendue ou une sous-classe valide l’assertion ; sans exception, elle échoue, et une autre exception se propage.

Exemples

import io
import unittest


class IntConversionTests(unittest.TestCase):
    def setUp(self):
        self.inputs = ('0', '7', '-3', 'not a number')

    def test_direct(self):
        self.assertEqual(int(self.inputs[0]), 0)
        self.assertEqual(int(self.inputs[1]), 7)
        self.assertEqual(int(self.inputs[2]), -3)
        with self.assertRaises(ValueError):
            int(self.inputs[3])

    def test_subtests(self):
        for text, expected in zip(self.inputs[:3], (0, 7, -3)):
            with self.subTest(text=text):
                self.assertEqual(int(text), expected)
        self.assertRaises(ValueError, int, self.inputs[3])


if __name__ == '__main__':
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(IntConversionTests)
    report = io.StringIO()
    result = unittest.TextTestRunner(stream=report).run(suite)
    if not result.wasSuccessful():
        raise SystemExit(report.getvalue())
    print(f'{result.testsRun} tests passed')

Résultat

2 tests passed

`test_direct` effectue trois comparaisons directes et vérifie l’exception dans un bloc `with`. `test_subtests` reprend les mêmes entrées dans des sous-tests identifiés et passe la fonction à `assertRaises`. Le `2` compte les méthodes de test, pas les sous-tests.

Leçons associées

  • Python · Leçon 37 · Avancé · Version : 5
  • Python · Leçon 34 · Intermédiaire · Version : 3

Sources