From 4ba373840a7b299fff4a7bcc1001e32dffceee86 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Tue, 10 Sep 2013 09:49:39 -0400 Subject: Fixed #16534 -- Improved ability to customize DiscoverRunner Added DiscoverRunner.test_suite and .test_runner attributes. Thanks tomchristie for the suggestion and jcd for the patch. --- docs/topics/testing/advanced.txt | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'docs/topics/testing') diff --git a/docs/topics/testing/advanced.txt b/docs/topics/testing/advanced.txt index a4c425aeb9..d02912dd31 100644 --- a/docs/topics/testing/advanced.txt +++ b/docs/topics/testing/advanced.txt @@ -338,6 +338,25 @@ execute and tear down the test suite. Attributes ~~~~~~~~~~ +.. attribute:: DiscoverRunner.test_suite + + .. versionadded:: 1.7 + + The class used to build the test suite. By default it is set to + ``unittest.TestSuite``. This can be overridden if you wish to implement + different logic for collecting tests. + +.. attribute:: DiscoverRunner.test_runner + + .. versionadded:: 1.7 + + This is the class of the low-level test runner which is used to execute + the individual tests and format the results. By default it is set to + ``unittest.TextTestRunner``. Despite the unfortunate similarity in + naming conventions, this is not the same type of class as + ``DiscoverRunner``, which covers a broader set of responsibilites. You + can override this attribute to modify the way tests are run and reported. + .. attribute:: DiscoverRunner.test_loader This is the class that loads tests, whether from TestCases or modules or -- cgit v1.3