Browse Source

Fixed #21068 -- Added some docs for DiscoverRunner

Thanks jcd.
Tim Graham 11 years ago
parent
commit
e4b012feeb
1 changed files with 13 additions and 4 deletions
  1. 13 4
      docs/topics/testing/advanced.txt

+ 13 - 4
docs/topics/testing/advanced.txt

@@ -298,11 +298,13 @@ Defining a test runner
 
 .. currentmodule:: django.test.runner
 
+.. versionadded:: 1.6
+
 A test runner is a class defining a ``run_tests()`` method. Django ships
-with a ``DiscoverRunner`` class that defines the default Django
-testing behavior. This class defines the ``run_tests()`` entry point,
-plus a selection of other methods that are used to by ``run_tests()`` to
-set up, execute and tear down the test suite.
+with a ``DiscoverRunner`` class that defines the default Django testing
+behavior. This class defines the ``run_tests()`` entry point, plus a
+selection of other methods that are used to by ``run_tests()`` to set up,
+execute and tear down the test suite.
 
 .. class:: DiscoverRunner(pattern='test*.py', top_level=None, verbosity=1, interactive=True, failfast=True, **kwargs)
 
@@ -339,6 +341,13 @@ set up, execute and tear down the test suite.
 Attributes
 ~~~~~~~~~~
 
+.. attribute:: DiscoverRunner.test_loader
+
+    This is the class that loads tests, whether from TestCases or modules or
+    otherwise and bundles them into test suites for the runner to execute.
+    By default it is set to ``unittest.defaultTestLoader``. You can override
+    this attribute if your tests are going to be loaded in unusual ways.
+
 .. attribute:: DiscoverRunner.option_list
 
     This is the tuple of ``optparse`` options which will be fed into the