Rewrote the PyUnit description so that it now recommends to use

run_suite() instead of run_unittest().  Best practice is to plan for
multiple test classes.
This commit is contained in:
Barry Warsaw 2002-04-23 21:39:00 +00:00
parent 99d17006c1
commit 5ca537473b
1 changed files with 16 additions and 6 deletions

View File

@ -40,9 +40,13 @@ The test_support helper module provides a two functions for use by
PyUnit based tests in the Python regression testing framework: PyUnit based tests in the Python regression testing framework:
run_unittest() takes a unittest.TestCase derived class as a parameter run_unittest() takes a unittest.TestCase derived class as a parameter
and runs the tests defined in that class, and run_suite() takes a and runs the tests defined in that class, and run_suite() takes a
populated TestSuite instance and runs the tests.. All test methods in populated TestSuite instance and runs the tests. run_suite() is
the Python regression framework have names that start with "test_" and preferred because unittest files typically grow multiple test classes,
use lower-case names with words separated with underscores. and you might as well be prepared.
All test methods in the Python regression framework have names that
start with "test_" and use lower-case names with words separated with
underscores.
All PyUnit-based tests in the Python test suite use boilerplate that All PyUnit-based tests in the Python test suite use boilerplate that
looks like this: looks like this:
@ -50,11 +54,17 @@ looks like this:
import unittest import unittest
import test_support import test_support
class MyTestCase(unittest.TestCase): class MyTestCase1(unittest.TestCase):
# define test methods here... # define test methods here...
class MyTestCase2(unittest.TestCase):
# define more test methods here...
def test_main(): def test_main():
test_support.run_unittest(MyTestCase) suite = unittest.TestSuite()
suite.addTest(unittest.makeSuite(MyTestCase1))
suite.addTest(unittest.makeSuite(MyTestCase2))
test_support.run_suite(suite)
if __name__ == "__main__": if __name__ == "__main__":
test_main() test_main()
@ -153,7 +163,7 @@ top level:
make test make test
{WINDOWS] Run rt.bat from your PCBuild directory. Read the comments at [WINDOWS] Run rt.bat from your PCBuild directory. Read the comments at
the top of rt.bat for the use of special -d, -O and -q options processed the top of rt.bat for the use of special -d, -O and -q options processed
by rt.bat. by rt.bat.