summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2020-07-10 09:20:18 +0200
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2020-07-10 19:10:28 +0200
commitb44e2d62c0993589726914b4edf8f6063abac257 (patch)
treec9a72e1ca959b0bd7b6e9e491aa66c3fab0167db
parent7808a04fe5d84412fce63645c3e773186ab6b67f (diff)
[3.0.x] Refs #30676 -- Added pdb argument to DiscoverRunner docs.
Backport of 2c43840dfba42ed02574a270d826fda08e4b50d1 from master
-rw-r--r--docs/topics/testing/advanced.txt9
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/topics/testing/advanced.txt b/docs/topics/testing/advanced.txt
index cdff8889ee..f49177fe59 100644
--- a/docs/topics/testing/advanced.txt
+++ b/docs/topics/testing/advanced.txt
@@ -499,7 +499,7 @@ 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=False, keepdb=False, reverse=False, debug_mode=False, debug_sql=False, test_name_patterns=None, **kwargs)
+.. class:: DiscoverRunner(pattern='test*.py', top_level=None, verbosity=1, interactive=True, failfast=False, keepdb=False, reverse=False, debug_mode=False, debug_sql=False, test_name_patterns=None, pdb=False, **kwargs)
``DiscoverRunner`` will search for tests in any file matching ``pattern``.
@@ -541,6 +541,9 @@ execute and tear down the test suite.
``test_name_patterns`` can be used to specify a set of patterns for
filtering test methods and classes by their names.
+ If ``pdb`` is ``True``, a debugger (``pdb`` or ``ipdb``) will be spawned at
+ each test error or failure.
+
Django may, from time to time, extend the capabilities of the test runner
by adding new arguments. The ``**kwargs`` declaration allows for this
expansion. If you subclass ``DiscoverRunner`` or write your own test
@@ -551,6 +554,10 @@ execute and tear down the test suite.
custom arguments by calling ``parser.add_argument()`` inside the method, so
that the :djadmin:`test` command will be able to use those arguments.
+ .. versionadded:: 3.0
+
+ The ``pdb`` argument was added.
+
Attributes
~~~~~~~~~~