Software: Apache/2.0.54 (Unix) mod_perl/1.99_09 Perl/v5.8.0 mod_ssl/2.0.54 OpenSSL/0.9.7l DAV/2 FrontPage/5.0.2.2635 PHP/4.4.0 mod_gzip/2.0.26.1a 

uname -a: Linux snow.he.net 4.4.276-v2-mono-1 #1 SMP Wed Jul 21 11:21:17 PDT 2021 i686 

uid=99(nobody) gid=98(nobody) groups=98(nobody) 

Safe-mode: OFF (not secure)

/opt/doc/python-2.3.4/html/Python-Docs-2.3.4/lib/   drwxr-xr-x
Free 318.3 GB of 458.09 GB (69.48%)
                            Encoder    Tools    Proc.    FTP brute    Sec.    SQL    PHP-code    Update    Feedback    Self remove    Logout    

Viewing file:     testloader-objects.html (9.93 KB)      -rw-r--r--

Python Library Reference

Previous: 5.3.7 TestResult Objects Up: 5.3 unittest Next: 5.4 test

---

5.3.8 TestLoader Objects

The TestLoader class is used to create test suites from classes and modules. Normally, there is no need to create an instance of this class; the unittest module provides an instance that can be shared as the defaultTestLoader module attribute. Using a subclass or instance would allow customization of some configurable properties.

TestLoader objects have the following methods:

loadTestsFromTestCase(

testCaseClass)

Return a suite of all tests cases contained in the TestCase-derived class testCaseClass.

loadTestsFromModule(

module)

Return a suite of all tests cases contained in the given module. This method searches module for classes derived from TestCase and creates an instance of the class for each test method defined for the class.

Warning: While using a hierarchy of Testcase-derived classes can be convenient in sharing fixtures and helper functions, defining test methods on base classes that are not intended to be instantiated directly does not play well with this method. Doing so, however, can be useful when the fixtures are different and defined in subclasses.

loadTestsFromName(

name[, module])

Return a suite of all tests cases given a string specifier.

The specifier name is a ``dotted name'' that may resolve either to a module, a test case class, a test method within a test case class, or a callable object which returns a TestCase or TestSuite instance. For example, if you have a module SampleTests containing a TestCase-derived class SampleTestCase with three test methods (test_one(), test_two(), and test_three()), the specifier 'SampleTests.SampleTestCase' would cause this method to return a suite which will run all three test methods. Using the specifier 'SampleTests.SampleTestCase.test_two' would cause it to return a test suite which will run only the test_two() test method. The specifier can refer to modules and packages which have not been imported; they will be imported as a side-effect.

The method optionally resolves name relative to a given module.

loadTestsFromNames(

names[, module])

Similar to loadTestsFromName(), but takes a sequence of names rather than a single name. The return value is a test suite which supports all the tests defined for each name.

getTestCaseNames(

testCaseClass)

Return a sorted sequence of method names found within testCaseClass.

The following attributes of a TestLoader can be configured either by subclassing or assignment on an instance:

testMethodPrefix

String giving the prefix of method names which will be interpreted as test methods. The default value is 'test'.

sortTestMethodsUsing

Function to be used to compare method names when sorting them in getTestCaseNames(). The default value is the built-in cmp() function; it can be set to None to disable the sort.

suiteClass

Callable object that constructs a test suite from a list of tests. No methods on the resulting object are needed. The default value is the TestSuite class.

---

Python Library Reference

Previous: 5.3.7 TestResult Objects Up: 5.3 unittest Next: 5.4 test

---

Release 2.3.4, documentation updated on May 20, 2004.