WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

unittest.TestSuite

TestSuite fasst Testfälle und verschachtelte Suiten für einen gemeinsamen Lauf zusammen.

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

Syntax

unittest.TestSuite(tests=())

TestSuite fasst Testfälle und verschachtelte Suiten für einen gemeinsamen Lauf zusammen.

Vor dem Lauf liefert wiederholte Iteration dieselben Elemente. debug() führt Tests ohne Fehlererfassung im Ergebnis aus, sodass die Ausnahme den Aufrufer erreicht. addTest fügt ein Element hinzu, addTests nimmt ein iterierbares Objekt an. countTestCases zählt auch Fälle in inneren Suiten. run(result) verwendet und liefert das gemeinsame Ergebnis. Vor der Ausführung ergeben sich im Beispiel 1 und 0.

Die Standardsuite kann danach Referenzen auf Tests freigeben.

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

Beispiele

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())

Ergebnis

1 0
1 True

Die Standardsuite kann danach Referenzen auf Tests freigeben.

Quellen