[1.1.X] Fixed #12412 -- Clarified the documentation around file handling by the test client. Thanks to Gabriel Hurley for the draft patch.

Backport of r13166 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.1.X@13172 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Russell Keith-Magee 2010-05-09 06:48:32 +00:00
parent 6df4ffd4f4
commit 5be6c7fc60
1 changed files with 10 additions and 2 deletions

View File

@ -577,8 +577,16 @@ arguments at time of construction:
(The name ``attachment`` here is not relevant; use whatever name your
file-processing code expects.)
Note that you should manually close the file after it has been provided
to ``post()``.
Note that if you wish to use the same file handle for multiple
``post()`` calls then you will need to manually reset the file
pointer between posts. The easiest way to do this is to
manually close the file after it has been provided to
``post()``, as demonstrated above.
You should also ensure that the file is opened in a way that
allows the data to be read. If your file contains binary data
such as an image, this means you will need to open the file in
``rb`` (read binary) mode.
The ``extra`` argument acts the same as for :meth:`Client.get`.