Ticket #4501: 4501_v4.diff

docs/topics/testing.txt

@@ -552 +552 @@
 feature is useful if you're using the test-runner script in a shell script and
 need to test for success or failure at that level.
 
+Integration with coverage.py module
+-----------------------------------
+
+Checking code coverage is important part of testing applications and it's
+strongly recommended to do it. Django can be integrated with `coverage.py module`_.
+First, you have to `install coverage.py`_. Now you are ready to use coverage
+module. Type in your shell:
+
+.. _coverage.py module: http://nedbatchelder.com/code/coverage/
+.. _install coverage.py: http://pypi.python.org/pypi/coverage
+
+.. code-block:: bash
+
+   coverage -x manage.py test myapp
+
+Now tests were launched and coverage data was collected. For each executed file
+there was created another file with name ending with ``,cover`` containing data
+about coverage. You can open these files or you can print coverage summary
+by typing following command.
+
+.. code-block:: bash
+
+   coverage -r
+
+After this all don't forget to delete all collected data by typing:
+
+.. code-block:: bash
+
+   coverage -e
+
+Note that if you don't run last command, coverage data from next launching
+will be append to existing data.
+
 Testing tools
 =============