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

CKTIS / Python

unittest.TestSuite

TestSuite regroupe des cas de test et des suites imbriquées pour une exécution commune.

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

Syntaxe

unittest.TestSuite(tests=())

TestSuite regroupe des cas de test et des suites imbriquées pour une exécution commune.

Avant l’exécution, des itérations successives donnent les mêmes éléments. debug() exécute les tests sans consigner les erreurs dans un résultat et laisse les exceptions atteindre l’appelant. addTest ajoute un élément et addTests accepte un itérable. countTestCases compte aussi les cas des suites internes. run(result) leur transmet le résultat commun et le renvoie. Avant l’exécution l’exemple compte 1 et 0.

La suite par défaut peut ensuite libérer les références aux tests.

import unittest
events=[]
class Check(unittest.TestCase):
    def test_a(self): events.append('a')
    def test_b(self): events.append('b')
inner=unittest.TestSuite([Check('test_a')])
outer=unittest.TestSuite()
outer.addTests([inner,Check('test_b')])
assert outer.countTestCases()==2
r=unittest.TestResult()
assert outer.run(r) is r and events==['a','b'] and r.testsRun==2
case=Check('test_a')
suite=unittest.TestSuite([case])
assert list(suite)==list(suite)==[case]
def bad(): raise ValueError('from case')
try: unittest.TestSuite([unittest.FunctionTestCase(bad)]).debug()
except ValueError as ex: assert str(ex)=='from case'
else: raise AssertionError

Exemples

import unittest
class Check(unittest.TestCase):
    def test_total(self): self.assertEqual(2 + 3, 5)

suite = unittest.TestSuite([Check("test_total")])
print(suite.countTestCases(), unittest.TestSuite().countTestCases())
r = unittest.TestResult()
suite.run(r)
print(r.testsRun, r.wasSuccessful())

Résultat

1 0
1 True

La suite par défaut peut ensuite libérer les références aux tests.

Sources