summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2019-03-27 12:12:51 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2019-03-28 10:00:12 +0100
commite449c3a832ff2a4e3fa83cec6909d0476ed14110 (patch)
treeeb7ee572556baee1e19ff33f9748b18ba19f375a /docs/ref
parent881362986a1ee8f650752de8471a895890b71f96 (diff)
Doc'd that HttpResponse accepts bytestrings.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/request-response.txt16
1 files changed, 8 insertions, 8 deletions
diff --git a/docs/ref/request-response.txt b/docs/ref/request-response.txt
index 34dd44ef1d..4adc20bb25 100644
--- a/docs/ref/request-response.txt
+++ b/docs/ref/request-response.txt
@@ -631,12 +631,13 @@ Usage
Passing strings
~~~~~~~~~~~~~~~
-Typical usage is to pass the contents of the page, as a string, to the
-:class:`HttpResponse` constructor::
+Typical usage is to pass the contents of the page, as a string or bytestring,
+to the :class:`HttpResponse` constructor::
>>> from django.http import HttpResponse
>>> response = HttpResponse("Here's the text of the Web page.")
>>> response = HttpResponse("Text only, please.", content_type="text/plain")
+ >>> response = HttpResponse(b'Bytestrings are also accepted.')
But if you want to add content incrementally, you can use ``response`` as a
file-like object::
@@ -735,16 +736,15 @@ Attributes
Methods
-------
-.. method:: HttpResponse.__init__(content='', content_type=None, status=200, reason=None, charset=None)
+.. method:: HttpResponse.__init__(content=b'', content_type=None, status=200, reason=None, charset=None)
Instantiates an ``HttpResponse`` object with the given page content and
content type.
- ``content`` should be an iterator or a string. If it's an
- iterator, it should return strings, and those strings will be
- joined together to form the content of the response. If it is not
- an iterator or a string, it will be converted to a string when
- accessed.
+ ``content`` is most commonly an iterator, bytestring, or string. Other
+ types will be converted to a bytestring by encoding their string
+ representation. Iterators should return strings or bytestrings and those
+ will be joined together to form the content of the response.
``content_type`` is the MIME type optionally completed by a character set
encoding and is used to fill the HTTP ``Content-Type`` header. If not