diff options
| author | Tim Graham <timograham@gmail.com> | 2015-12-10 11:23:12 -0500 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2015-12-11 08:07:43 -0500 |
| commit | 9f3ce6d987f2a78dc97f6147efac41071c2ec085 (patch) | |
| tree | 8271c3ab931ca324c056c58efd6d747875a0fdda /docs/topics | |
| parent | 515f149e4d51ddcf32db0be440da726c0ca867b4 (diff) | |
[1.9.x] Refs #25899 -- Improved visibility of TEST database settings in testing docs.
Backport of 738bda8a6feea95d07b73246365e75b3d25e3466 from master
Diffstat (limited to 'docs/topics')
| -rw-r--r-- | docs/topics/testing/overview.txt | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/docs/topics/testing/overview.txt b/docs/topics/testing/overview.txt index 1d11d71553..1fd8a1c9f8 100644 --- a/docs/topics/testing/overview.txt +++ b/docs/topics/testing/overview.txt @@ -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. |
