CKTIS / Python
unittest : échecs d’assertion et erreurs de test
Exécutez une suite de tests et utilisez `testsRun`, `failures` et `errors` pour produire un bilan déterministe sans analyser le rapport textuel.
Version : Python 3.12
Syntaxe
runner = unittest.TextTestRunner(stream=stream)
result = runner.run(suite)
result.testsRun
result.failures
result.errors
len(result.failures)
len(result.errors)En Python 3.12, unittest.TextTestRunner.run(suite) exécute la suite et renvoie un objet unittest.TestResult, de type TextTestResult par défaut. Lisez l’objet renvoyé plutôt que d’analyser le rapport textuel. result.testsRun compte les tests démarrés, et non les tests réussis ni la taille de la suite avant son exécution.
Quand self.assertEqual(...) échoue, l’assertion lève une exception du type failureException du cas de test, qui vaut AssertionError par défaut. Lorsque unittest classe une exception comme échec ou comme erreur, il l’enregistre dans result.failures si son type est failureException ou une sous-classe de ce type, et dans result.errors sinon. Une exception ValueError non interceptée dans une méthode de test est donc une erreur par défaut, mais un échec si elle correspond à la valeur configurée de failureException. Si l’assertion échoue dans le corps d’une méthode de test décorée par @unittest.expectedFailure et que tearDown et les fonctions de nettoyage se terminent sans problème, le résultat est enregistré dans result.expectedFailures à la place. Chaque entrée de result.failures ou de result.errors associe un objet de test à une chaîne contenant la trace d’appels mise en forme. Comptez les entrées avec len(result.failures) et len(result.errors).
Ne soustrayez pas les longueurs des deux listes de testsRun pour compter les tests réussis : les tests ignorés sont enregistrés à part et un test peut produire plusieurs entrées, par exemple avec subTest. Pour le verdict global, utilisez result.wasSuccessful() : cette méthode renvoie aussi False lorsqu’un test marqué comme devant échouer réussit de façon inattendue.
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("unexpected value")
suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
result = unittest.TextTestRunner(stream=io.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 test réussit, un autre échoue sur une assertion et le troisième déclenche une erreur. `io.StringIO()` capture le rapport de l’exécuteur : seule la ligne des compteurs s’affiche dans la console.
Leçons associées
- Python · Leçon 37 · Avancé · Version : 5