Fixed #31509 -- Made DiscoverRunner enable faulthandler by default.

3 files changed, 20 insertions, 1 deletions

diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index b0913becf0..99cdafd2c8 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -1515,6 +1515,14 @@ installed, ``ipdb`` is used instead.
 Discards output (``stdout`` and ``stderr``) for passing tests, in the same way
 as :option:`unittest's --buffer option<unittest.-b>`.
 
+.. django-admin-option:: --no-faulthandler
+
+.. versionadded:: 3.2
+
+Django automatically calls :func:`faulthandler.enable()` when starting the
+tests, which allows it to print a traceback if the interpreter crashes. Pass
+``--no-faulthandler`` to disable this behavior.
+
 ``testserver``
 --------------
 
diff --git a/docs/releases/3.2.txt b/docs/releases/3.2.txt
index 0c877bc1f5..64b3b0257c 100644
--- a/docs/releases/3.2.txt
+++ b/docs/releases/3.2.txt
@@ -266,6 +266,10 @@ Tests
   creating deep copies with :py:func:`copy.deepcopy`. Assigning objects which
   don't support ``deepcopy()`` is deprecated and will be removed in Django 4.1.
 
+* :class:`~django.test.runner.DiscoverRunner` now enables
+  :py:mod:`faulthandler` by default. This can be disabled by using the
+  :option:`test --no-faulthandler` option.
+
 * :class:`~django.test.Client` now preserves the request query string when
   following 307 and 308 redirects.
 
diff --git a/docs/topics/testing/advanced.txt b/docs/topics/testing/advanced.txt
index c4fbee060a..06bd351ccf 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, pdb=False, buffer=False, **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, buffer=False, enable_faulthandler=True, **kwargs)
 
     ``DiscoverRunner`` will search for tests in any file matching ``pattern``.
 
@@ -557,6 +557,9 @@ execute and tear down the test suite.
 
     If ``buffer`` is ``True``, outputs from passing tests will be discarded.
 
+    If ``enable_faulthandler`` is ``True``, :py:mod:`faulthandler` will be
+    enabled.
+
     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
@@ -571,6 +574,10 @@ execute and tear down the test suite.
 
         The ``buffer`` argument was added.
 
+    .. versionadded:: 3.2
+
+        The ``enable_faulthandler`` argument was added.
+
 Attributes
 ~~~~~~~~~~