Please document django.test.Client.defaults

[sailorfred@…]

The documentation makes it clear that I can provide an HTTP_USER_AGENT to the test client's methods, but it would have been nice to have it documented that the defaults exist, and how useful they are.

[Aymeric Augustin]

Defaults can also be passed in Client.__init__. Basically, these values just update the WSGI environ dictionary. There is no fixed list.

The values from the keywords argument to theget/post/etc. methods have precedence, then those passed in __init__, and then the defaults.

Indeed, this isn't documented.

[Russell Keith-Magee]

It is partially documented -- the **extra argument is listed, and an example (using HTTP_X_REQUESTED_WITH) is provided in ​the API docs for the test client. However, there is certainly room for a broad guide to the topic when the Test Client is introduced.

[Raúl Cumplido]

Hi I provide a first patch but I don't understand something in the comment from aaugustin:

The values from the keywords argument to theget/post/etc. methods have precedence, then those passed in __init__, and then the defaults.

I mean defaults are passed in __init__ then your comment shouldn't be something like this:

The values from the keywords argument to the get/post/etc. methods have precedence, than those defaults passed in __init__. Or I am missing something?

[Raúl Cumplido]

First patch

[Christopher Medrela]

I think lines 694-695 are too deep - the indentation should be one level of depth (see deleted lines 672-673 in your patch).

[anonymous]

Has a newer patch at github. Pull request at:
​https://github.com/django/django/pull/115

[Aymeric Augustin]

I left a few comments on the pull request, can you update it (squashing the commits), or maybe just do a new one?

[anonymous]

Updated:

​https://github.com/django/django/pull/115

[Aymeric Augustin <aymeric.augustin@…>]

In [875c76251710c9b643a4e6164b5570713fe024f5]:

Fixed #16916 -- Documented default headers for the test client.

Thanks sailorfred AT yahoo.com for the report and raulcd
for the initial version of the patch.