summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSamuel Gaist <samuel.gaist@idiap.ch>2019-02-23 00:10:33 +0100
committerTim Graham <timograham@gmail.com>2019-03-05 21:10:21 -0500
commit3e565b50a949d1cafee4708b7dabda5e3faabbe7 (patch)
tree82fd20a49d85fcecdc7db1931f387e37db16910d
parentcf903c4c0b76f4703957c25dd4366658cf976143 (diff)
[2.2.x] Doc'd the use of --noinput for test database handling.
Backport of 75840688f94c022cd2a62143149a30e6d2db8496 from master.
-rw-r--r--docs/topics/testing/overview.txt7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/topics/testing/overview.txt b/docs/topics/testing/overview.txt
index 12efb381c7..1eea7ead22 100644
--- a/docs/topics/testing/overview.txt
+++ b/docs/topics/testing/overview.txt
@@ -151,6 +151,13 @@ You can prevent the test databases from being destroyed by using the
runs. If the database does not exist, it will first be created. Any migrations
will also be applied in order to keep it up to date.
+As described in the previous section, if a test run is forcefully interrupted,
+the test database may not be destroyed. On the next run, you'll be asked
+whether you want to reuse or destroy the database. Use the :option:`test
+--noinput` option to suppress that prompt and automatically destroy the
+database. This can be useful when running tests on a continuous integration
+server where tests may be interrupted by a timeout, for example.
+
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