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

CKTIS / Python

Exécuter des tests et examiner le résultat de `TextTestRunner.run`

Exécutez une suite de tests ou un cas de test isolé, puis utilisez le `TestResult` renvoyé pour produire un bilan personnalisé sans analyser le rapport textuel.

Version : Python 3.12

Syntaxe

runner = unittest.TextTestRunner(stream=report_stream)
result = runner.run(test)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()

Dans Python 3.12, unittest.TextTestRunner.run reçoit une instance de TestSuite ou de TestCase, exécute les tests fournis et renvoie un objet TestResult (TextTestResult par défaut). Indépendamment de cette valeur de retour, le lanceur écrit un rapport textuel dans le flux choisi avec stream, qui vaut par défaut sys.stderr.

result.testsRun compte les tests démarrés, pas les tests réussis ou planifiés. result.failures et result.errors sont des listes de paires (test, trace d’exception formatée). Une assertion qui échoue, comme self.assertEqual(...), alimente failures ; une exception inattendue, comme une ValueError non interceptée dans une méthode de test, alimente errors. Utilisez len(...) pour compter les entrées de chaque liste.

result.wasSuccessful() renvoie True si aucun échec, aucune erreur et aucun succès inattendu n’ont été enregistrés. Un succès inattendu est la réussite d’un test marqué avec @unittest.expectedFailure. Les tests ignorés et les échecs attendus ne suffisent pas à faire renvoyer False. Ne remplacez pas cette méthode par un contrôle des deux seules listes et ne prenez pas True comme preuve qu’au moins un test a été exécuté.

Exemples

import io
import unittest


class ArithmeticTests(unittest.TestCase):
    def test_pass(self):
        self.assertEqual(2 + 2, 4)

    def test_failure(self):
        self.assertEqual(2 + 2, 5)

    def test_error(self):
        raise ValueError("intentional test error")


if __name__ == "__main__":
    suite = unittest.TestSuite([
        ArithmeticTests("test_pass"),
        ArithmeticTests("test_failure"),
        ArithmeticTests("test_error"),
    ])
    report_stream = io.StringIO()
    result = unittest.TextTestRunner(stream=report_stream).run(suite)
    print(f"Tests run: {result.testsRun}")
    print(f"Failures: {len(result.failures)}")
    print(f"Errors: {len(result.errors)}")
    print(f"Successful: {result.wasSuccessful()}")

Résultat

Tests run: 3
Failures: 1
Errors: 1
Successful: False

Un test réussit, un autre échoue sur une assertion et le troisième déclenche une erreur. `io.StringIO()` capture le rapport habituel du lanceur, durée comprise, de sorte que la console n’affiche que le bilan personnalisé de quatre lignes.

Leçons associées

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

Sources