[Python-checkins] cpython (merge 3.2 -> default): merge from 3.2. Updates to http.client documentation.
senthil.kumaran
python-checkins at python.org
Mon Jun 20 02:00:44 CEST 2011
http://hg.python.org/cpython/rev/f3e27bb31adf
changeset: 70883:f3e27bb31adf
parent: 70881:5dd75cdd445a
parent: 70882:d801b570b1dd
user: Senthil Kumaran <senthil at uthcode.com>
date: Sun Jun 19 16:57:49 2011 -0700
summary:
merge from 3.2. Updates to http.client documentation.
files:
Doc/library/http.client.rst | 13 ++++++++++++-
1 files changed, 12 insertions(+), 1 deletions(-)
diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst
--- a/Doc/library/http.client.rst
+++ b/Doc/library/http.client.rst
@@ -543,6 +543,9 @@
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 @@
>>> 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)
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list