Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

[1.5.x] Tweaked unit test 'quick start' explanation.

Thanks Jeremy Dunck.

Backport of 490672f from master
  • Loading branch information...
1 parent 0eddedf commit 63cab03f6ddd9faa5a770ae08791b2a70aa0a578 @timgraham timgraham committed
Showing with 7 additions and 13 deletions.
  1. +7 −13 docs/internals/contributing/writing-code/unit-tests.txt
20 docs/internals/contributing/writing-code/unit-tests.txt
@@ -29,15 +29,13 @@ Quickstart
Running the tests requires a Django settings module that defines the
databases to use. To make it easy to get started, Django provides a
sample settings module that uses the SQLite database. To run the tests
-with this sample ``settings`` module, ``cd`` into the Django
-``tests/`` directory and run:
+with this sample ``settings`` module:
.. code-block:: bash
- ./ --settings=test_sqlite
-If you get an ``ImportError: No module named django.contrib`` error,
-you need to add your install of Django to your ``PYTHONPATH``.
+ git clone django-repo
+ cd django-repo/tests
+ PYTHONPATH=..:$PYTHONPATH python ./ --settings=test_sqlite
.. _running-unit-tests-settings:
@@ -49,14 +47,10 @@ SQLite. If you want to test behavior using a different database (and
if you're proposing patches for Django, it's a good idea to test
across databases), you may need to define your own settings file.
-To run the tests with different settings, ``cd`` to the ``tests/`` directory
-and type:
-.. code-block:: bash
- ./
+To run the tests with different settings, ensure that the module is on your
+``PYTHONPATH`` and pass the module with ``--settings``.
-The :setting:`DATABASES` setting in this test settings module needs to define
+The :setting:`DATABASES` setting in any test settings module needs to define
two databases:
* A ``default`` database. This database should use the backend that

0 comments on commit 63cab03

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