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.