KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

unittest.TextTestRunner

TextTestRunner voert een geval of suite uit en schrijft het verslag naar stream, standaard stderr.

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

Syntax

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

TextTestRunner voert een geval of suite uit en schrijft het verslag naar stream, standaard stderr.

buffer=True vangt stdout en stderr van de test op, verwerpt ze bij succes en voegt ze bij fouten of mislukkingen toe. warnings stelt voor de uitvoering een waarschuwingsfilter zoals 'ignore' in. verbosity bepaalt het detailniveau en failfast stopt verdere tests na de eerste mislukking of fout. run geeft het resultaatobject terug.

Het voorbeeld controleert testsRun, wasSuccessful() en OK in StringIO onafhankelijk van de gemeten tijd.

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) voert een geval of suite uit, schrijft het verslag naar de ingestelde stream en geeft een resultaatobject. testsRun en wasSuccessful() controleren de uitkomst onafhankelijk van de getoonde duur.

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

Voorbeelden

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

Resultaat

1 True True

Het voorbeeld controleert testsRun, wasSuccessful() en OK in StringIO onafhankelijk van de gemeten tijd.

Bronnen