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 20:25:22 -0500
commit75840688f94c022cd2a62143149a30e6d2db8496 (patch)
tree0a96b9d3fa6be169a80e658cc61615a97a675b4e
parent4c086d7da4c5cf23935a5340dbb9a8d6835cf7cc (diff)
Doc'd the use of --noinput for test database handling.
-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