Browse Source

Fixed #33213 -- Doc'd testing code coverage in parallel and used it.

Paolo Melchiorre 2 years ago
parent
commit
69352d85fa
3 changed files with 12 additions and 5 deletions
  1. 1 1
      .gitignore
  2. 9 4
      docs/internals/contributing/writing-code/unit-tests.txt
  3. 2 0
      tests/.coveragerc

+ 1 - 1
.gitignore

@@ -13,6 +13,6 @@ docs/_build/
 docs/locale/
 docs/locale/
 node_modules/
 node_modules/
 tests/coverage_html/
 tests/coverage_html/
-tests/.coverage
+tests/.coverage*
 build/
 build/
 tests/report/
 tests/report/

+ 9 - 4
docs/internals/contributing/writing-code/unit-tests.txt

@@ -356,14 +356,19 @@ Contributors are encouraged to run coverage on the test suite to identify areas
 that need additional tests. The coverage tool installation and use is described
 that need additional tests. The coverage tool installation and use is described
 in :ref:`testing code coverage<topics-testing-code-coverage>`.
 in :ref:`testing code coverage<topics-testing-code-coverage>`.
 
 
-Coverage should be run in a single process to obtain accurate statistics. To
-run coverage on the Django test suite using the standard test settings:
+To run coverage on the Django test suite using the standard test settings:
 
 
 .. console::
 .. console::
 
 
-   $ coverage run ./runtests.py --settings=test_sqlite --parallel=1
+   $ coverage run ./runtests.py --settings=test_sqlite
 
 
-After running coverage, generate the html report by running:
+After running coverage, combine all coverage statistics by running:
+
+.. console::
+
+   $ coverage combine
+
+After that generate the html report by running:
 
 
 .. console::
 .. console::
 
 

+ 2 - 0
tests/.coveragerc

@@ -1,5 +1,7 @@
 [run]
 [run]
 branch = True
 branch = True
+concurrency = multiprocessing
+data_file = .coverages/.coverage
 omit =
 omit =
     */django/utils/autoreload.py
     */django/utils/autoreload.py
 source = django
 source = django