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:
parent
87170c72f9
commit
6447582b85
|
@ -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.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue