From a85148352773929e11324f3786ebe5a78f372d94 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Sat, 10 Jul 2010 12:20:38 +0000 Subject: #8564: update docs on integrating doctest/unittest with unittest(2) test discovery. --- Doc/library/doctest.rst | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/Doc/library/doctest.rst b/Doc/library/doctest.rst index 4b2a28d..420c73e 100644 --- a/Doc/library/doctest.rst +++ b/Doc/library/doctest.rst @@ -913,18 +913,16 @@ Unittest API 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 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` -test runners:: +containing doctests. To integrate with :mod:`unittest` test discovery, include +a :func:`load_tests` function in your test module:: import unittest import doctest - import my_module_with_doctests, and_another + import my_module_with_doctests - suite = unittest.TestSuite() - for mod in my_module_with_doctests, and_another: - suite.addTest(doctest.DocTestSuite(mod)) - runner = unittest.TextTestRunner() - runner.run(suite) + def load_tests(loader, tests, ignore): + tests.addTests(doctest.DocTestSuite(my_module_with_doctests)) + return test There are two main functions for creating :class:`unittest.TestSuite` instances from text files and modules with doctests: -- cgit v0.12