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

CKTIS / Python

Résultats unittest : tests lancés, échecs et erreurs

Exécutez une suite de tests et utilisez le résultat renvoyé pour compter séparément les tests lancés, les échecs d’assertion et les exceptions inattendues.

Version : Python 3.12

Syntaxe

result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)

Dans Python 3.12, unittest.TextTestRunner.run(suite) exécute la suite et renvoie un objet TestResult. result.testsRun compte les cas de test lancés, et non les cas trouvés lors de la découverte ni les seuls cas réussis. Un cas ignoré après son lancement peut aussi être compté.

result.failures consigne les échecs, par exemple celui d’une vérification assertEqual(). Les assertions de TestCase signalent un échec avec failureException, qui vaut AssertionError par défaut. result.errors consigne les exceptions inattendues, par exemple un RuntimeError non intercepté dans une méthode de test. Chaque entrée de ces deux listes est une paire formée de l’objet de test et d’une chaîne contenant une trace d’appel formatée.

Utilisez len(result.failures) et len(result.errors) pour compter les entrées sans analyser le rapport textuel. Ne soustrayez pas ces nombres de testsRun pour compter les réussites : des tests peuvent être ignorés, et un même cas peut contenir plusieurs sous-tests en échec. Pour connaître le résultat global, utilisez result.wasSuccessful(), qui renvoie aussi False en cas de réussite inattendue.

Exemples

import unittest
from io import StringIO


class SummaryTests(unittest.TestCase):
    def test_pass(self):
        self.assertEqual(1 + 1, 2)

    def test_failure(self):
        self.assertEqual(1 + 1, 3)

    def test_error(self):
        raise RuntimeError("unexpected problem")


suite = unittest.TestSuite([
    SummaryTests("test_pass"),
    SummaryTests("test_failure"),
    SummaryTests("test_error"),
])
result = unittest.TextTestRunner(stream=StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")

Résultat

testsRun=3 failures=1 errors=1

Un cas réussit, un autre échoue sur une assertion et le dernier lève `RuntimeError`. `StringIO` capture le rapport de l’exécuteur de tests : seule la ligne de comptage apparaît dans la console.

Leçons associées

  • Python · Leçon 37 · Avancé · Version : 5

Sources