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