Author: gabrielhurley
Date: 2011-08-18 15:31:32 -0700 (Thu, 18 Aug 2011)
New Revision: 16625
Modified:
django/trunk/docs/topics/testing.txt
Log:
Fixed #16608 -- Clarified the description of the destroy_test_db method and
cleaned up various other reST/Sphinx-related bits in the testing docs. Thanks
to Stan for the report and Julien for the draft patch.
Modified: django/trunk/docs/topics/testing.txt
===================================================================
--- django/trunk/docs/topics/testing.txt 2011-08-18 21:57:57 UTC (rev
16624)
+++ django/trunk/docs/topics/testing.txt 2011-08-18 22:31:32 UTC (rev
16625)
@@ -1278,6 +1278,7 @@
documentation<dumpdata>` for more details.
.. note::
+
If you've ever run :djadmin:`manage.py syncdb<syncdb>`, you've
already used a fixture without even knowing it! When you call
:djadmin:`syncdb` in the database for the first time, Django
@@ -1919,10 +1920,12 @@
magic hooks into the template system and restoring normal email
services.
+.. currentmodule:: django.db.connection.creation
+
The creation module of the database backend (``connection.creation``)
also provides some utilities that can be useful during testing.
-.. function:: create_test_db(verbosity=1, autoclobber=False)
+.. function:: create_test_db([verbosity=1, autoclobber=False])
Creates a new test database and runs ``syncdb`` against it.
@@ -1944,10 +1947,11 @@
:setting:`NAME` in :setting:`DATABASES` to match the name of the test
database.
-.. function:: destroy_test_db(old_database_name, verbosity=1)
+.. function:: destroy_test_db(old_database_name, [verbosity=1])
- Destroys the database whose name is in stored in :setting:`NAME` in the
- :setting:`DATABASES`, and sets :setting:`NAME` to use the
- provided name.
+ Destroys the database whose name is the value of :setting:`NAME` in
+ :setting:`DATABASES`, and sets :setting:`NAME` to the value of
+ ``old_database_name``.
- ``verbosity`` has the same behavior as in ``run_tests()``.
+ The ``verbosity`` argument has the same behavior as for
+ :class:`~django.test.simple.DjangoTestSuiteRunner`.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
