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

CKTIS / Python

unittest.TestResult.wasSuccessful — vérifier les résultats des tests

La méthode wasSuccessful() indique si les résultats enregistrés jusqu’ici ne contiennent aucun échec, aucune erreur ni aucun succès inattendu. Elle ne lance pas elle-même les tests.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

result.wasSuccessful()

unittest.TestResult.wasSuccessful() est une méthode d’instance appelée sans argument sous la forme result.wasSuccessful(). Elle renvoie un bool qui résume les résultats enregistrés jusqu’ici dans result ; elle ne lance pas les tests.

L’implémentation standard renvoie False si failures, errors ou unexpectedSuccesses ne sont pas vides. Les tests ignorés (skipped) et les échecs attendus (expectedFailures) ne provoquent pas à eux seuls le renvoi de False. Un test réussi décoré avec @unittest.expectedFailure constitue un succès inattendu et provoque le renvoi de False.

Un résultat vide renvoie True : cela ne prouve ni qu’un test a été exécuté ni que toute la suite est terminée. Vérifiez aussi testsRun si vous exigez que des tests aient été exécutés. L’exemple lance explicitement deux tests et rassemble leurs résultats dans un même objet.

Exemples

import unittest

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

    @unittest.expectedFailure
    def test_unexpected_success(self):
        self.assertTrue(True)

result = unittest.TestResult()
print(result.testsRun, result.wasSuccessful())
Checks('test_pass').run(result)
print(result.testsRun, result.wasSuccessful())
Checks('test_unexpected_success').run(result)
print(result.testsRun, result.wasSuccessful())

Résultat

0 True
1 True
2 False

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources