diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/django-admin.txt | 14 | ||||
| -rw-r--r-- | docs/releases/4.0.txt | 3 |
2 files changed, 13 insertions, 4 deletions
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index 4af510731f..0a346b5af7 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -1467,10 +1467,12 @@ Enables :ref:`SQL logging <django-db-logger>` for failing tests. If Runs tests in separate parallel processes. Since modern processors have multiple cores, this allows running tests significantly faster. -By default ``--parallel`` runs one process per core according to -:func:`multiprocessing.cpu_count()`. You can adjust the number of processes -either by providing it as the option's value, e.g. ``--parallel=4``, or by -setting the :envvar:`DJANGO_TEST_PROCESSES` environment variable. +Using ``--parallel`` without a value, or with the value ``auto``, runs one test +process per core according to :func:`multiprocessing.cpu_count()`. You can +override this by passing the desired number of processes, e.g. +``--parallel 4``. You can also enable ``--parallel`` without passing the flag +by setting the :envvar:`DJANGO_TEST_PROCESSES` environment variable to the +desired number of processes. Django distributes test cases — :class:`unittest.TestCase` subclasses — to subprocesses. If there are fewer test cases than configured processes, Django @@ -1511,6 +1513,10 @@ don't. in order to exchange them between processes. See :ref:`python:pickle-picklable` for details. +.. versionchanged:: 4.0 + + Support for the value ``auto`` was added. + .. option:: --tag TAGS Runs only tests :ref:`marked with the specified tags <topics-tagging-tests>`. diff --git a/docs/releases/4.0.txt b/docs/releases/4.0.txt index 825a669e00..3af4726bc9 100644 --- a/docs/releases/4.0.txt +++ b/docs/releases/4.0.txt @@ -350,6 +350,9 @@ Tests * Django test runner now supports a :option:`--shuffle <test --shuffle>` option to execute tests in a random order. +* The :option:`test --parallel` option now supports the value ``auto`` to run + one test process for each processor core. + URLs ~~~~ |