From 28634394f53b9ab27d3419cfde047ee78e491d97 Mon Sep 17 00:00:00 2001 From: Rigel Di Scala Date: Mon, 13 Oct 2014 12:10:00 +0100 Subject: Fixed #23606 -- Implemented Client and RequestFactory trace() methods. Thanks KevinEtienne for the suggestion. --- docs/releases/1.8.txt | 4 ++++ docs/topics/testing/advanced.txt | 4 ++-- docs/topics/testing/tools.txt | 14 ++++++++++++++ 3 files changed, 20 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/releases/1.8.txt b/docs/releases/1.8.txt index eef836f6aa..23c6deeef1 100644 --- a/docs/releases/1.8.txt +++ b/docs/releases/1.8.txt @@ -372,6 +372,10 @@ Requests and Responses Tests ^^^^^ +* The :class:`RequestFactory.trace() ` + and :class:`Client.trace() ` methods were + implemented, allowing you to create ``TRACE`` requests in your tests. + * The ``count`` argument was added to :meth:`~django.test.SimpleTestCase.assertTemplateUsed`. This allows you to assert that a template was rendered a specific number of times. 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` -- cgit v1.3