Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Updated the settings variables required to run the internal test suit…

…e. Also

fixed up the paths to existing tests and added a link to the documentation for
writing new tests for Django itself.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@3771 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit d411a9a777721eae732d4ca1de8ec7dfcd30a98c 1 parent a5f4a02
Malcolm Tredinnick authored September 21, 2006

Showing 1 changed file with 22 additions and 13 deletions. Show diff stats Hide diff stats

  1. 35  docs/contributing.txt
35  docs/contributing.txt
@@ -247,18 +247,23 @@ Django tarball. It's our policy to make sure all tests pass at all times.
247 247
 
248 248
 The tests cover:
249 249
 
250  
-    * Models and the database API (``tests/testapp/models``).
251  
-    * The cache system (``tests/otherthests/cache.py``).
252  
-    * The ``django.utils.dateformat`` module (``tests/othertests/dateformat.py``).
253  
-    * Database typecasts (``tests/othertests/db_typecasts.py``).
254  
-    * The template system (``tests/othertests/templates.py`` and
255  
-      ``tests/othertests/defaultfilters.py``).
256  
-    * ``QueryDict`` objects (``tests/othertests/httpwrappers.py``).
257  
-    * Markup template tags (``tests/othertests/markup.py``).
258  
-    * The ``django.utils.timesince`` module (``tests/othertests/timesince.py``).
  250
+    * Models and the database API (``tests/modeltests/``).
  251
+    * The cache system (``tests/regressiontests/cache.py``).
  252
+    * The ``django.utils.dateformat`` module (``tests/regressiontests/dateformat/``).
  253
+    * Database typecasts (``tests/regressiontests/db_typecasts/``).
  254
+    * The template system (``tests/regressiontests/templates/`` and
  255
+      ``tests/regressiontests/defaultfilters/``).
  256
+    * ``QueryDict`` objects (``tests/regressiontests/httpwrappers/``).
  257
+    * Markup template tags (``tests/regressiontests/markup/``).
259 258
 
260 259
 We appreciate any and all contributions to the test suite!
261 260
 
  261
+The Django tests all use the testing infrastructure that ships with Django for
  262
+testing applications. See `Testing Django Applications`_ for an explanation of
  263
+how to write new tests.
  264
+
  265
+.. _Testing Django Applications: http://www.djangoproject.com/documentation/testing/
  266
+
262 267
 Running the unit tests
263 268
 ----------------------
264 269
 
@@ -268,10 +273,14 @@ To run the tests, ``cd`` to the ``tests/`` directory and type::
268 273
 
269 274
 Yes, the unit tests need a settings module, but only for database connection
270 275
 info -- the ``DATABASE_ENGINE``, ``DATABASE_USER`` and ``DATABASE_PASSWORD``.
271  
-
272  
-The unit tests will not touch your database; they create a new database, called
273  
-``django_test_db``, which is deleted when the tests are finished. This means
274  
-your user account needs permission to execute ``CREATE DATABASE``.
  276
+You will also need a ``ROOT_URLCONF`` setting (it's value is ignored; it just
  277
+needs to be present) and a ``SITE_ID`` setting (any integer value will do) in
  278
+order for all the tests to pass.
  279
+
  280
+The unit tests will not touch your existing databases; they create a new
  281
+database, called ``django_test_db``, which is deleted when the tests are
  282
+finished. This means your user account needs permission to execute ``CREATE
  283
+DATABASE``.
275 284
 
276 285
 Requesting features
277 286
 ===================

0 notes on commit d411a9a

Please sign in to comment.
Something went wrong with that request. Please try again.