Fixed #33757 -- Clarified Client.post() file upload example.

This commit is contained in:
Tim Graham 2022-06-02 13:03:34 -04:00 committed by GitHub
parent fbac2a4dd8
commit 61badf1d58
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 3 additions and 4 deletions

View File

@ -241,15 +241,14 @@ Use the ``django.test.Client`` class to make requests.
Submitting files is a special case. To POST a file, you need only
provide the file field name as a key, and a file handle to the file you
wish to upload as a value. For example::
wish to upload as a value. For example, if your form has fields
``name`` and ``attachment``, the latter a
:class:`~django.forms.FileField`::
>>> c = Client()
>>> with open('wishlist.doc', 'rb') as fp:
... c.post('/customers/wishes/', {'name': 'fred', 'attachment': fp})
(The name ``attachment`` here is not relevant; use whatever name your
file-processing code expects.)
You may also provide any file-like object (e.g., :class:`~io.StringIO` or
:class:`~io.BytesIO`) as a file handle. If you're uploading to an
:class:`~django.db.models.ImageField`, the object needs a ``name``