summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChris Jerdonek <chris.jerdonek@gmail.com>2016-08-15 07:10:40 -0700
committerTim Graham <timograham@gmail.com>2016-08-23 15:08:20 -0400
commita3db480393d0065fc69834057f0e02a4afc65df9 (patch)
tree5595ed9baf8a4a60e3a8c16707f7690fda55c5da /docs
parentbc1e2d8e8edde6cc7d2657c68242a13ee65a15b8 (diff)
Fixed #27061 -- Added a TEST['TEMPLATE'] setting for PostgreSQL.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/databases.txt10
-rw-r--r--docs/ref/settings.txt14
-rw-r--r--docs/releases/1.11.txt3
3 files changed, 27 insertions, 0 deletions
diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt
index 983b7525c3..257324330d 100644
--- a/docs/ref/databases.txt
+++ b/docs/ref/databases.txt
@@ -164,6 +164,16 @@ lookups that use the ``LIKE`` operator in their SQL, as is done with the
.. _PostgreSQL operator class: http://www.postgresql.org/docs/current/static/indexes-opclass.html
+Test database templates
+-----------------------
+
+.. versionadded:: 1.11
+
+You can use the :setting:`TEST['TEMPLATE'] <TEST_TEMPLATE>` setting to specify
+a `template`_ (e.g. ``'template0'``) from which to create a test database.
+
+.. _template: https://www.postgresql.org/docs/current/static/sql-createdatabase.html
+
Speeding up test execution with non-durable settings
----------------------------------------------------
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 445e504e98..856d9186a8 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -738,6 +738,20 @@ the database state between tests if you don't have transactions). You can set
this to ``False`` to speed up creation time if you don't have any test classes
with :ref:`serialized_rollback=True <test-case-serialized-rollback>`.
+.. setting:: TEST_TEMPLATE
+
+``TEMPLATE``
+^^^^^^^^^^^^
+
+.. versionadded:: 1.11
+
+This is a PostgreSQL-specific setting.
+
+The name of a `template`_ (e.g. ``'template0'``) from which to create the test
+database.
+
+.. _template: https://www.postgresql.org/docs/current/static/sql-createdatabase.html
+
.. setting:: TEST_CREATE
``CREATE_DB``
diff --git a/docs/releases/1.11.txt b/docs/releases/1.11.txt
index 802a09e6a9..b9fe8de41d 100644
--- a/docs/releases/1.11.txt
+++ b/docs/releases/1.11.txt
@@ -159,6 +159,9 @@ Database backends
on PostgreSQL 9.5+ and Oracle to execute queries with
``FOR UPDATE SKIP LOCKED``.
+* Added the :setting:`TEST['TEMPLATE'] <TEST_TEMPLATE>` setting to let
+ PostgreSQL users specify a template for creating the test database.
+
Email
~~~~~