diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/internals/deprecation.txt | 3 | ||||
| -rw-r--r-- | docs/releases/4.0.txt | 3 | ||||
| -rw-r--r-- | docs/topics/testing/advanced.txt | 20 |
3 files changed, 18 insertions, 8 deletions
diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt index 69a21109f3..c56b875aed 100644 --- a/docs/internals/deprecation.txt +++ b/docs/internals/deprecation.txt @@ -27,6 +27,9 @@ details on these changes. * The default sitemap protocol for sitemaps built outside the context of a request will change from ``'http'`` to ``'https'``. +* The ``extra_tests`` argument for ``DiscoverRunner.build_suite()`` and + ``DiscoverRunner.run_tests()`` will be removed. + .. _deprecation-removed-in-4.1: 4.1 diff --git a/docs/releases/4.0.txt b/docs/releases/4.0.txt index ee3922c9b6..9f63a3d3ed 100644 --- a/docs/releases/4.0.txt +++ b/docs/releases/4.0.txt @@ -533,6 +533,9 @@ Miscellaneous * The default sitemap protocol for sitemaps built outside the context of a request will change from ``'http'`` to ``'https'`` in Django 5.0. +* The ``extra_tests`` argument for :meth:`.DiscoverRunner.build_suite` and + :meth:`.DiscoverRunner.run_tests` is deprecated. + Features removed in 4.0 ======================= 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. |