Commit 9f3ce6d9 authored by Tim Graham's avatar Tim Graham
Browse files

[1.9.x] Refs #25899 -- Improved visibility of TEST database settings in testing docs.

Backport of 738bda8a from master
parent 515f149e
Loading
Loading
Loading
Loading
+8 −8
Original line number Diff line number Diff line
@@ -153,14 +153,14 @@ when all the tests have been executed.
   be created. Any migrations will also be applied in order to keep it
   up to date.

By default the test databases get their names by prepending ``test_``
to the value of the :setting:`NAME` settings for the databases
defined in :setting:`DATABASES`. When using the SQLite database engine
the tests will by default use an in-memory database (i.e., the
database will be created in memory, bypassing the filesystem
entirely!). If you want to use a different database name, specify
:setting:`NAME <TEST_NAME>` in the :setting:`TEST <DATABASE-TEST>`
dictionary for any given database in :setting:`DATABASES`.
The default test database names are created by prepending ``test_`` to the
value of each :setting:`NAME` in :setting:`DATABASES`. When using SQLite, the
tests will use an in-memory database by default (i.e., the database will be
created in memory, bypassing the filesystem entirely!). The :setting:`TEST
<DATABASE-TEST>` dictionary in :setting:`DATABASES` offers a number of settings
to configure your test database. For example, if you want to use a different
database name, specify :setting:`NAME <TEST_NAME>` in the :setting:`TEST
<DATABASE-TEST>` dictionary for any given database in :setting:`DATABASES`.

On PostgreSQL, :setting:`USER` will also need read access to the built-in
``postgres`` database.