CKTIS / Python
unittest.TextTestRunner
TextTestRunner izvede primer ali zbirko in poročilo zapiše v stream, privzeto stderr.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
unittest.TextTestRunner(stream=output, verbosity=1, failfast=False)TextTestRunner izvede primer ali zbirko in poročilo zapiše v stream, privzeto stderr.
buffer=True prestreže stdout in stderr testa, ju pri uspehu zavrže in ju pri napaki ali neuspehu priloži. warnings za čas izvedbe nastavi filter opozoril, denimo 'ignore'. verbosity določa podrobnost, failfast pa ustavi nadaljnje teste po prvem neuspehu ali napaki. run vrne objekt z rezultatom.
Primer preveri testsRun, wasSuccessful() in prisotnost OK v StringIO neodvisno od izmerjenega časa.
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) izvede primer ali zbirko, izpiše poročilo v nastavljeni tok in vrne objekt z rezultatom. testsRun in wasSuccessful() preverita izid neodvisno od izpisanega časa.
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()
Primeri
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())
Rezultat
1 True True
Primer preveri testsRun, wasSuccessful() in prisotnost OK v StringIO neodvisno od izmerjenega časa.