From cd9fcd4e8073490a52c9e79133ada4661cb7db38 Mon Sep 17 00:00:00 2001 From: Aymeric Augustin Date: Thu, 5 Feb 2015 20:31:02 +0100 Subject: Implemented a parallel test runner. --- docs/ref/django-admin.txt | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'docs/ref/django-admin.txt') diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index 35a02eecc8..939ea61731 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -1257,6 +1257,26 @@ The ``--debug-sql`` option can be used to enable :ref:`SQL logging ` for failing tests. If :djadminopt:`--verbosity` is ``2``, then queries in passing tests are also output. +.. django-admin-option:: --parallel + +.. versionadded:: 1.9 + +The ``--parallel`` option can be used to run tests in parallel in separate +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 ``DJANGO_TEST_PROCESSES`` environment variable. + +This option requires the third-party ``tblib`` package to display tracebacks +correctly: + +.. code-block:: console + + $ pip install tblib + testserver -------------------------------- -- cgit v1.3