CKTIS / Python
TestResult : un rapport unittest en quatre lignes
Exécutez une suite de tests et utilisez le `TestResult` renvoyé pour indiquer le nombre de tests démarrés, les échecs, les erreurs et le résultat global.
Version : Python 3.12
Syntaxe
result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()En Python 3.12, unittest.TextTestRunner.run(suite) exécute la suite et renvoie par défaut un TextTestResult, une sous-classe de TestResult. Conservez cet objet pour produire un rapport personnalisé sans analyser le texte de sortie de l’exécuteur.
result.testsRun est un entier qui compte les tests démarrés, et non les tests réussis ou prévus. Un test ignoré compte si son démarrage a été enregistré. En revanche, une erreur de préparation d’une classe de tests peut être enregistrée sans qu’aucun de ses tests ne démarre.
result.failures et result.errors sont des listes, pas des compteurs. La première contient les échecs, par exemple une assertion assertEqual non satisfaite ; la seconde contient les erreurs, par exemple un ValueError inattendu. Chaque entrée associe un objet qui identifie le test à une trace d’appels formatée sous forme de chaîne. Utilisez len(...) pour compter les entrées.
result.wasSuccessful() est une méthode : gardez les parenthèses. Elle renvoie True uniquement si aucun échec, aucune erreur et aucune réussite inattendue n’a été enregistré. Une réussite inattendue est celle d’un test marqué avec @unittest.expectedFailure. Les tests ignorés et les échecs attendus ne suffisent pas à la faire renvoyer False.
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 ValueError("demo error")
if __name__ == "__main__":
suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
with io.StringIO() as stream:
result = unittest.TextTestRunner(stream=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 dernier lève `ValueError`. L’exécuteur écrit son rapport habituel dans `io.StringIO` : seules les quatre lignes personnalisées s’affichent dans la console.
Leçons associées
- Python · Leçon 34 · Intermédiaire · Version : 3