summaryrefslogtreecommitdiff
path: root/docs
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 /docs
parent4c086d7da4c5cf23935a5340dbb9a8d6835cf7cc (diff)
Doc'd the use of --noinput for test database handling.
Diffstat (limited to 'docs')
-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