Merge pull request #2327 from bopace/http-header-docs

[MRG+1] Added documentation about accessing header values
2016-10-20 09:05:14 +02:00 · 2016-10-20 09:05:14 +02:00 · 871eec9827
parent 71c8278f57 fd016ee71b
commit 871eec9827
1 changed files with 7 additions and 1 deletions
--- a/docs/topics/request-response.rst
+++ b/docs/topics/request-response.rst
@ -507,7 +507,13 @@ Response objects

    .. attribute:: Response.headers

-        A dictionary-like object which contains the response headers.
+        A dictionary-like object which contains the response headers. Values can
+        be accessed using :meth:`get` to return the first header value with the
+        specified name or :meth:`getlist` to return all header values with the
+        specified name. For example, this call will give you all cookies in the
+        headers::
+
+            response.headers.getlist('Set-Cookie')

    .. attribute:: Response.body