Corrected some formatting in the testing docs.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@8513 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Russell Keith-Magee 2008-08-24 08:04:06 +00:00
parent 87170c72f9
commit 6447582b85
1 changed files with 13 additions and 0 deletions

View File

@ -655,10 +655,12 @@ A test client has two attributes that store persistent state information. You
can access these properties as part of a test condition. can access these properties as part of a test condition.
.. attribute:: Client.cookies .. attribute:: Client.cookies
A Python ``SimpleCookie`` object, containing the current values of all the A Python ``SimpleCookie`` object, containing the current values of all the
client cookies. See the `Cookie module documentation`_ for more. client cookies. See the `Cookie module documentation`_ for more.
.. attribute:: Client.session .. attribute:: Client.session
A dictionary-like object containing session information. See the :ref:`session A dictionary-like object containing session information. See the :ref:`session
documentation<topics-http-sessions>` for full details. documentation<topics-http-sessions>` for full details.
@ -863,15 +865,18 @@ methods such as ``assertTrue`` and ``assertEquals``, Django's custom
useful for testing Web applications: useful for testing Web applications:
.. method:: TestCase.assertContains(response, text, count=None, status_code=200) .. method:: TestCase.assertContains(response, text, count=None, status_code=200)
Asserts that a ``Response`` instance produced the given ``status_code`` and Asserts that a ``Response`` instance produced the given ``status_code`` and
that ``text`` appears in the content of the response. If ``count`` is that ``text`` appears in the content of the response. If ``count`` is
provided, ``text`` must occur exactly ``count`` times in the response. provided, ``text`` must occur exactly ``count`` times in the response.
.. method:: TestCase.assertNotContains(response, text, status_code=200) .. method:: TestCase.assertNotContains(response, text, status_code=200)
Asserts that a ``Response`` instance produced the given ``status_code`` and Asserts that a ``Response`` instance produced the given ``status_code`` and
that ``text`` does not appears in the content of the response. that ``text`` does not appears in the content of the response.
.. method:: assertFormError(response, form, field, errors) .. method:: assertFormError(response, form, field, errors)
Asserts that a field on a form raises the provided list of errors when Asserts that a field on a form raises the provided list of errors when
rendered on the form. rendered on the form.
@ -887,16 +892,19 @@ useful for testing Web applications:
expected as a result of form validation. expected as a result of form validation.
.. method:: assertTemplateUsed(response, template_name) .. method:: assertTemplateUsed(response, template_name)
Asserts that the template with the given name was used in rendering the Asserts that the template with the given name was used in rendering the
response. response.
The name is a string such as ``'admin/index.html'``. The name is a string such as ``'admin/index.html'``.
.. method:: assertTemplateNotUsed(response, template_name) .. method:: assertTemplateNotUsed(response, template_name)
Asserts that the template with the given name was *not* used in rendering Asserts that the template with the given name was *not* used in rendering
the response. the response.
.. method:: assertRedirects(response, expected_url, status_code=302, target_status_code=200) .. method:: assertRedirects(response, expected_url, status_code=302, target_status_code=200)
Asserts that the response return a ``status_code`` redirect status, Asserts that the response return a ``status_code`` redirect status,
it redirected to ``expected_url`` (including any GET data), and the subsequent it redirected to ``expected_url`` (including any GET data), and the subsequent
page was received with ``target_status_code``. page was received with ``target_status_code``.
@ -1003,6 +1011,7 @@ By convention, a test runner should be called ``run_tests``. The only strict
requirement is that it has the same arguments as the Django test runner: requirement is that it has the same arguments as the Django test runner:
.. function:: run_tests(test_labels, verbosity=1, interactive=True, extra_tests=[]) .. function:: run_tests(test_labels, verbosity=1, interactive=True, extra_tests=[])
``test_labels`` is a list of strings describing the tests to be run. A test ``test_labels`` is a list of strings describing the tests to be run. A test
label can take one of three forms: label can take one of three forms:
@ -1040,11 +1049,13 @@ To assist in the creation of your own test runner, Django provides
a number of utility methods in the ``django.test.utils`` module. a number of utility methods in the ``django.test.utils`` module.
.. function:: setup_test_environment() .. function:: setup_test_environment()
Performs any global pre-test setup, such as the installing the Performs any global pre-test setup, such as the installing the
instrumentation of the template rendering system and setting up instrumentation of the template rendering system and setting up
the dummy ``SMTPConnection``. the dummy ``SMTPConnection``.
.. function:: teardown_test_environment() .. function:: teardown_test_environment()
Performs any global post-test teardown, such as removing the Performs any global post-test teardown, such as removing the
black magic hooks into the template system and restoring normal e-mail black magic hooks into the template system and restoring normal e-mail
services. services.
@ -1053,6 +1064,7 @@ The creation module of the database backend (``connection.creation``) also
provides some utilities that can be useful during testing. 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. Creates a new test database and runs ``syncdb`` against it.
``verbosity`` has the same behavior as in ``run_tests()``. ``verbosity`` has the same behavior as in ``run_tests()``.
@ -1074,6 +1086,7 @@ provides some utilities that can be useful during testing.
the test database that it created. the test database that it created.
.. 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 the :setting:`DATABASE_NAME` setting Destroys the database whose name is in the :setting:`DATABASE_NAME` setting
and restores the value of :setting:`DATABASE_NAME` to the provided name. and restores the value of :setting:`DATABASE_NAME` to the provided name.