summaryrefslogtreecommitdiff
path: root/docs/topics/testing
diff options
context:
space:
mode:
Diffstat (limited to 'docs/topics/testing')
-rw-r--r--docs/topics/testing/advanced.txt4
-rw-r--r--docs/topics/testing/tools.txt14
2 files changed, 16 insertions, 2 deletions
diff --git a/docs/topics/testing/advanced.txt b/docs/topics/testing/advanced.txt
index bbd8584328..d817cf4f02 100644
--- a/docs/topics/testing/advanced.txt
+++ b/docs/topics/testing/advanced.txt
@@ -21,8 +21,8 @@ restricted subset of the test client API:
* It only has access to the HTTP methods :meth:`~Client.get()`,
:meth:`~Client.post()`, :meth:`~Client.put()`,
- :meth:`~Client.delete()`, :meth:`~Client.head()` and
- :meth:`~Client.options()`.
+ :meth:`~Client.delete()`, :meth:`~Client.head()`,
+ :meth:`~Client.options()`, and :meth:`~Client.trace()`.
* These methods accept all the same arguments *except* for
``follows``. Since this is just a factory for producing
diff --git a/docs/topics/testing/tools.txt b/docs/topics/testing/tools.txt
index 43c5fcaf48..439910aa8a 100644
--- a/docs/topics/testing/tools.txt
+++ b/docs/topics/testing/tools.txt
@@ -316,6 +316,20 @@ Use the ``django.test.Client`` class to make requests.
The ``follow``, ``secure`` and ``extra`` arguments act the same as for
:meth:`Client.get`.
+ .. method:: Client.trace(path, follow=False, secure=False, **extra)
+
+ .. versionadded:: 1.8
+
+ Makes a TRACE request on the provided ``path`` and returns a
+ ``Response`` object. Useful for simulating diagnostic probes.
+
+ Unlike the other request methods, ``data`` is not provided as a keyword
+ parameter in order to comply with :rfc:`2616`, which mandates that
+ TRACE requests should not have an entity-body.
+
+ The ``follow``, ``secure``, and ``extra`` arguments act the same as for
+ :meth:`Client.get`.
+
.. method:: Client.login(**credentials)
If your site uses Django's :doc:`authentication system</topics/auth/index>`