innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

[1.6.x] Fixed #21625 -- incorrect documentation for DiscoverRunner.build_suite 

Backport of b62031441b from master.
This commit is contained in:
Tianyi Wang 2013-12-16 21:47:11 +00:00 committed by Baptiste Mispelon
parent e888760854
commit 60517c9c09
1 changed files with 14 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
docs/topics/testing/advanced.txt
View File

@ -363,21 +363,9 @@ Methods
Run the test suite. Run the test suite.
``test_labels`` is a list of strings describing the tests to be run. A test ``test_labels`` allows you to specify which tests to run and supports
label can take one of four forms: several formats (see :meth:`DiscoverRunner.build_suite` for a list of
supported formats).
* ``path.to.test_module.TestCase.test_method`` -- Run a single test method
in a test case.
* ``path.to.test_module.TestCase`` -- Run all the test methods in a test
case.
* ``path.to.module`` -- Search for and run all tests in the named Python
package or module.
* ``path/to/directory`` -- Search for and run all tests below the named
directory.
If ``test_labels`` has a value of ``None``, the test runner will search for
tests in all files below the current directory whose names match its
``pattern`` (see above).
``extra_tests`` is a list of extra ``TestCase`` instances to add to the ``extra_tests`` is a list of extra ``TestCase`` instances to add to the
suite that is executed by the test runner. These extra tests are run suite that is executed by the test runner. These extra tests are run
@ -396,15 +384,20 @@ Methods
Constructs a test suite that matches the test labels provided. Constructs a test suite that matches the test labels provided.
``test_labels`` is a list of strings describing the tests to be run. A test ``test_labels`` is a list of strings describing the tests to be run. A test
label can take one of three forms: label can take one of four forms:
* ``app.TestCase.test_method`` -- Run a single test method in a test * ``path.to.test_module.TestCase.test_method`` -- Run a single test method
in a test case.
* ``path.to.test_module.TestCase`` -- Run all the test methods in a test
case. case.
* ``app.TestCase`` -- Run all the test methods in a test case. * ``path.to.module`` -- Search for and run all tests in the named Python
* ``app`` -- Search for and run all tests in the named application. package or module.
* ``path/to/directory`` -- Search for and run all tests below the named
directory.
If ``test_labels`` has a value of ``None``, the test runner should run If ``test_labels`` has a value of ``None``, the test runner will search for
search for tests in all the applications in :setting:`INSTALLED_APPS`. tests in all files below the current directory whose names match its
``pattern`` (see above).
``extra_tests`` is a list of extra ``TestCase`` instances to add to the ``extra_tests`` is a list of extra ``TestCase`` instances to add to the
suite that is executed by the test runner. These extra tests are run suite that is executed by the test runner. These extra tests are run