summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorSenthil Kumaran <senthil@uthcode.com>2011-06-19 23:57:49 (GMT)
committerSenthil Kumaran <senthil@uthcode.com>2011-06-19 23:57:49 (GMT)
commit9f90470aa6ded8ab2b1bdf0c943396e651f373b4 (patch)
tree3970bf16080216491f02ef2b7de327869a901185 /Doc/library
parent019d0f27a3fc8d4daa7caea8c041cd26d5873950 (diff)
parentce9b596c04626c734993106acf4ccebd517a71d8 (diff)
downloadcpython-9f90470aa6ded8ab2b1bdf0c943396e651f373b4.zip
cpython-9f90470aa6ded8ab2b1bdf0c943396e651f373b4.tar.gz
cpython-9f90470aa6ded8ab2b1bdf0c943396e651f373b4.tar.bz2
merge from 3.2. Updates to http.client documentation.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/http.client.rst13
1 files changed, 12 insertions, 1 deletions
diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst
index 704585b..d16b808 100644
--- a/Doc/library/http.client.rst
+++ b/Doc/library/http.client.rst
@@ -543,6 +543,9 @@ statement.
A debugging hook. If :attr:`debuglevel` is greater than zero, messages
will be printed to stdout as the response is read and parsed.
+.. attribute:: HTTPResponse.closed
+
+ Is True if the stream is closed.
Examples
--------
@@ -555,7 +558,15 @@ Here is an example session that uses the ``GET`` method::
>>> r1 = conn.getresponse()
>>> print(r1.status, r1.reason)
200 OK
- >>> data1 = r1.read()
+ >>> data1 = r1.read() # This will return entire content.
+ >>> # The following example demonstrates reading data in chunks.
+ >>> conn.request("GET", "/index.html")
+ >>> r1 = conn.getresponse()
+ >>> while not r1.closed:
+ ... print(r1.read(200)) # 200 bytes
+ b'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
+ ...
+ >>> # Example of an invalid request
>>> conn.request("GET", "/parrot.spam")
>>> r2 = conn.getresponse()
>>> print(r2.status, r2.reason)