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:01:39 +0200
commit33457aa3cfc775c2939547212fbb403c46c9afd9 (patch)
treeea1b9e7101e5a3dd5d5ef36783c48e380bd9eede
parentfb9add3c7dd22ac2f4ea0a2ec1e9fd6d76b1d9b8 (diff)
[3.1.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 8aca92ea36..ad50026800 100644
--- a/docs/topics/testing/advanced.txt
+++ b/docs/topics/testing/advanced.txt
@@ -510,7 +510,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``.
@@ -552,6 +552,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
@@ -562,6 +565,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
~~~~~~~~~~