From 56f9579105c324ff15250423bf9f8bdf1634cfb4 Mon Sep 17 00:00:00 2001 From: Jacob Walls Date: Thu, 15 Jul 2021 17:56:41 -0400 Subject: Fixed #32655 -- Deprecated extra_tests argument for DiscoverRunner.build_suite()/run_tests(). --- docs/topics/testing/advanced.txt | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) (limited to 'docs/topics/testing') diff --git a/docs/topics/testing/advanced.txt b/docs/topics/testing/advanced.txt index dcc1be7f44..f94da75ece 100644 --- a/docs/topics/testing/advanced.txt +++ b/docs/topics/testing/advanced.txt @@ -631,7 +631,7 @@ Attributes Methods ~~~~~~~ -.. method:: DiscoverRunner.run_tests(test_labels, extra_tests=None, **kwargs) +.. method:: DiscoverRunner.run_tests(test_labels, **kwargs) Run the test suite. @@ -639,9 +639,11 @@ Methods several formats (see :meth:`DiscoverRunner.build_suite` for a list of supported formats). - ``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 - in addition to those discovered in the modules listed in ``test_labels``. + .. deprecated:: 4.0 + + ``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 in + addition to those discovered in the modules listed in ``test_labels``. This method should return the number of tests that failed. @@ -658,7 +660,7 @@ Methods :func:`~django.test.utils.setup_test_environment` and setting :setting:`DEBUG` to ``self.debug_mode`` (defaults to ``False``). -.. method:: DiscoverRunner.build_suite(test_labels=None, extra_tests=None, **kwargs) +.. method:: DiscoverRunner.build_suite(test_labels=None, **kwargs) Constructs a test suite that matches the test labels provided. @@ -678,9 +680,11 @@ Methods 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 - suite that is executed by the test runner. These extra tests are run - in addition to those discovered in the modules listed in ``test_labels``. + .. deprecated:: 4.0 + + ``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 in + addition to those discovered in the modules listed in ``test_labels``. Returns a ``TestSuite`` instance ready to be run. -- cgit v1.3