Browse files

Fixed #12412 -- Clarified the documentation around file handling by t…

…he test client. Thanks to Gabriel Hurley for the draft patch.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 5a74f0c commit bae2fa6f5cfd6827c0bdd995fe72dbb6794b7f9d @freakboy3742 freakboy3742 committed May 9, 2010
Showing with 10 additions and 2 deletions.
  1. +10 −2 docs/topics/testing.txt
@@ -668,8 +668,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`.

0 comments on commit bae2fa6

Please sign in to comment.