From: Senthil Kumaran Date: Sun, 19 Jun 2011 23:56:49 +0000 (-0700) Subject: Fix closes Issue12315 - Updates to http.client documentation. X-Git-Tag: v3.2.2rc1~223^2~6 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ce9b596c04626c734993106acf4ccebd517a71d8;p=python Fix closes Issue12315 - Updates to http.client documentation. --- diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst index 704585b525..d16b80814b 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'>> # Example of an invalid request >>> conn.request("GET", "/parrot.spam") >>> r2 = conn.getresponse() >>> print(r2.status, r2.reason)