CKTIS / Python
TestResult.testsRun : compter les tests démarrés
Exécutez une suite avec `unittest.TextTestRunner.run()` et lisez `testsRun`, `failures` et `errors` dans l’objet renvoyé pour produire un résumé.
Version : Python 3.12
Syntaxe
result = unittest.TextTestRunner().run(suite)
result.testsRun # int
len(result.failures)
len(result.errors)Dans Python 3.12, unittest.TextTestRunner.run(suite) exécute la suite et renvoie un objet résultat. TestResult.testsRun est un attribut entier : une fois l’appel terminé, lisez result.testsRun sans parenthèses. Le compteur standard augmente au démarrage d’un cas de test, pas quand celui-ci réussit. Un cas ignoré individuellement est compté même si le corps de sa méthode n’est pas exécuté. Les appels à subTest() ne sont pas comptés séparément.
result.failures et result.errors sont des listes d’entrées contenant des traces de pile formatées. Une assertion non satisfaite, par exemple avec assertEqual(), est enregistrée dans failures ; une exception inattendue comme RuntimeError est enregistrée dans errors. Utilisez len() pour compter les entrées de chaque liste. Ne soustrayez pas ces nombres de testsRun pour calculer le nombre de tests réussis : les cas ignorés sont enregistrés séparément dans result.skipped et un cas peut produire plusieurs entrées, par exemple si plusieurs sous-tests échouent.
Pour compter plutôt les cas que contient la suite, appelez suite.countTestCases() avant de la lancer. Avec failfast=True, l’exécution peut s’arrêter avant que tous les cas aient démarré. Une erreur dans setUpClass() peut être enregistrée dans errors alors qu’aucun cas de cette classe n’a démarré. Lisez les compteurs dans l’objet résultat plutôt que d’analyser le rapport textuel.
Exemples
import io
import unittest
class DemoTests(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 RuntimeError("unexpected error")
@unittest.skip("demonstrate a skipped test")
def test_skip(self):
self.fail("this body is not executed")
suite = unittest.TestSuite(
DemoTests(name)
for name in ("test_pass", "test_failure", "test_error", "test_skip")
)
with io.StringIO() as report:
result = unittest.TextTestRunner(stream=report, failfast=False).run(suite)
print(f"testsRun={result.testsRun}")
print(f"failures={len(result.failures)}")
print(f"errors={len(result.errors)}")
print(f"skipped={len(result.skipped)}")Résultat
testsRun=4 failures=1 errors=1 skipped=1
Un cas réussit, un échoue sur une assertion, un lève `RuntimeError` et un est ignoré. `io.StringIO` capture le rapport d’exécution : la console n’affiche que les quatre compteurs, sans trace de pile ni durée.
Leçons associées
- Python · Leçon 37 · Avancé · Version : 5
Sources
- Python 3.12 unittest — TestResult.testsRun
- Python 3.12 unittest — TextTestRunner.run
- Python 3.12 unittest — TestResult
- Python 3.12 unittest — TestSuite.countTestCases
- Python 3.12 unittest — Class and Module Fixtures
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 io — StringIO