From ddcf51a0ba21ac967406239cd0434dae490964ab Mon Sep 17 00:00:00 2001 From: Luke Plant Date: Fri, 20 Jun 2008 15:34:51 +0000 Subject: [PATCH] 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 --- docs/contributing.txt | 24 +++++++++++++++++------- 1 file 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//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 ===================