summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorLuke Plant <L.Plant.98@cantab.net>2008-06-20 15:34:51 +0000
committerLuke Plant <L.Plant.98@cantab.net>2008-06-20 15:34:51 +0000
commitddcf51a0ba21ac967406239cd0434dae490964ab (patch)
treeb3f1164a89e899bc5ad1a445687b64796972da87 /docs
parent9cf3048b0801aeefd5b5a78ad407b234265d1ffa (diff)
Updated information about unit tests, contrib apps in particular.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@7714 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs')
-rw-r--r--docs/contributing.txt24
1 files changed, 17 insertions, 7 deletions
diff --git a/docs/contributing.txt b/docs/contributing.txt
index c5f98bec11..1775b27174 100644
--- a/docs/contributing.txt
+++ b/docs/contributing.txt
@@ -702,13 +702,8 @@ Django tarball. It's our policy to make sure all tests pass at all times.
The tests cover:
* Models and the database API (``tests/modeltests/``).
- * The cache system (``tests/regressiontests/cache.py``).
- * The ``django.utils.dateformat`` module (``tests/regressiontests/dateformat/``).
- * Database typecasts (``tests/regressiontests/db_typecasts/``).
- * The template system (``tests/regressiontests/templates/`` and
- ``tests/regressiontests/defaultfilters/``).
- * ``QueryDict`` objects (``tests/regressiontests/httpwrappers/``).
- * Markup template tags (``tests/regressiontests/markup/``).
+ * Everything else in core Django code (``tests/regressiontests``)
+ * Contrib apps (``django/contrib/<contribapp>/tests``, see below)
We appreciate any and all contributions to the test suite!
@@ -755,6 +750,21 @@ for generic relations and internationalization, type::
PYTHONPATH=..
./runtests.py --settings=settings generic_relations i18n
+Contrib apps
+------------
+
+Tests for apps in ``django/contrib/`` go in their respective directories,
+in a ``tests.py`` file. (You can split the tests over multiple modules
+by using a ``tests`` folder in the normal Python way).
+
+For the tests to be found, a ``models.py`` file must exist (it doesn't
+have to have anything in it).
+
+To run tests for just one contrib app (e.g. ``markup``), use the same
+method as above::
+
+ ./runtests.py --settings=settings markup
+
Requesting features
===================