[Python-checkins] cpython (3.2): Fix closes Issue12315 - Updates to http.client documentation.

Mon Jun 20 02:00:44 CEST 2011

http://hg.python.org/cpython/rev/d801b570b1dd
changeset:   70882:d801b570b1dd
branch:      3.2
parent:      70880:9e58a638f028
user:        Senthil Kumaran <senthil at uthcode.com>
date:        Sun Jun 19 16:56:49 2011 -0700
summary:
  Fix closes Issue12315 - 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
