mirror of
https://github.com/python/cpython.git
synced 2025-09-27 18:59:43 +00:00
#8564: update docs on integrating doctest/unittest with unittest(2) test discovery.
This commit is contained in:
parent
1c616a5c92
commit
a851483527
1 changed files with 6 additions and 8 deletions
|
@ -913,18 +913,16 @@ Unittest API
|
||||||
As your collection of doctest'ed modules grows, you'll want a way to run all
|
As your collection of doctest'ed modules grows, you'll want a way to run all
|
||||||
their doctests systematically. :mod:`doctest` provides two functions that can
|
their doctests systematically. :mod:`doctest` provides two functions that can
|
||||||
be used to create :mod:`unittest` test suites from modules and text files
|
be used to create :mod:`unittest` test suites from modules and text files
|
||||||
containing doctests. These test suites can then be run using :mod:`unittest`
|
containing doctests. To integrate with :mod:`unittest` test discovery, include
|
||||||
test runners::
|
a :func:`load_tests` function in your test module::
|
||||||
|
|
||||||
import unittest
|
import unittest
|
||||||
import doctest
|
import doctest
|
||||||
import my_module_with_doctests, and_another
|
import my_module_with_doctests
|
||||||
|
|
||||||
suite = unittest.TestSuite()
|
def load_tests(loader, tests, ignore):
|
||||||
for mod in my_module_with_doctests, and_another:
|
tests.addTests(doctest.DocTestSuite(my_module_with_doctests))
|
||||||
suite.addTest(doctest.DocTestSuite(mod))
|
return test
|
||||||
runner = unittest.TextTestRunner()
|
|
||||||
runner.run(suite)
|
|
||||||
|
|
||||||
There are two main functions for creating :class:`unittest.TestSuite` instances
|
There are two main functions for creating :class:`unittest.TestSuite` instances
|
||||||
from text files and modules with doctests:
|
from text files and modules with doctests:
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue