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

CKTIS / Python

unittest.TextTestRunner

TextTestRunner exécute un cas ou une suite et écrit le rapport dans stream, par défaut stderr.

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

Syntaxe

unittest.TextTestRunner(stream=output, verbosity=1, failfast=False)

TextTestRunner exécute un cas ou une suite et écrit le rapport dans stream, par défaut stderr.

buffer=True capture stdout et stderr du test, les écarte en cas de succès et les joint en cas d’erreur ou d’échec. warnings applique un filtre d’avertissements tel que 'ignore' pendant l’exécution. verbosity règle le niveau de détail et failfast arrête les tests après le premier échec ou la première erreur. run renvoie l’objet résultat.

L’exemple vérifie testsRun, wasSuccessful() et la présence de OK dans StringIO sans dépendre de la durée mesurée.

import unittest,io
class A(unittest.TestCase):
    def test_fail(self): self.fail('sample')
    def test_next(self): pass
out=io.StringIO()
r=unittest.TextTestRunner(stream=out,verbosity=2,failfast=True).run(unittest.defaultTestLoader.loadTestsFromTestCase(A))
assert r.testsRun==1 and len(r.failures)==1 and not r.wasSuccessful()
assert 'test_fail' in out.getvalue() and 'FAILED' in out.getvalue()
import warnings,contextlib,sys
class Capture(unittest.TestCase):
    def test_a(self): print('discard');warnings.warn('quiet')
    def test_b(self): print('retain',file=sys.stderr);self.fail('broken')
out=io.StringIO()
with contextlib.redirect_stderr(io.StringIO()),contextlib.redirect_stdout(io.StringIO()):
    result=unittest.TextTestRunner(stream=out,buffer=True,warnings='ignore').run(unittest.defaultTestLoader.loadTestsFromTestCase(Capture))
assert 'retain' in result.failures[0][1] and 'discard' not in out.getvalue()
assert 'UserWarning: quiet' not in out.getvalue()
class Warn(unittest.TestCase):
    def test_warn(self): warnings.warn('filter-probe')
for mode, visible in [('always',True),('ignore',False)]:
    capture=io.StringIO()
    with contextlib.redirect_stderr(capture):
        unittest.TextTestRunner(stream=io.StringIO(),buffer=False,warnings=mode).run(Warn('test_warn'))
    assert ('UserWarning: filter-probe' in capture.getvalue()) is visible

unittest.TextTestRunner.run

run(test) exécute un cas ou une suite, écrit le rapport dans le flux configuré et renvoie un objet résultat. testsRun et wasSuccessful() contrôlent le résultat indépendamment de la durée affichée.

import io,unittest
out=io.StringIO()
runner=unittest.TextTestRunner(stream=out,verbosity=0)
suite=unittest.TestSuite([unittest.FunctionTestCase(lambda:None)])
result=runner.run(suite)
assert result.testsRun==1 and result.wasSuccessful() and "OK" in out.getvalue()

Exemples

import unittest
import io

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

out = io.StringIO()
r = unittest.TextTestRunner(stream=out).run(Check("test_total"))
print(r.testsRun, r.wasSuccessful(), "OK" in out.getvalue())

Résultat

1 True True

L’exemple vérifie testsRun, wasSuccessful() et la présence de OK dans StringIO sans dépendre de la durée mesurée.

Sources