From ce9b596c04626c734993106acf4ccebd517a71d8 Mon Sep 17 00:00:00 2001 From: Senthil Kumaran Date: Sun, 19 Jun 2011 16:56:49 -0700 Subject: Fix closes Issue12315 - Updates to http.client documentation. --- Doc/library/http.client.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) 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'>> # Example of an invalid request >>> conn.request("GET", "/parrot.spam") >>> r2 = conn.getresponse() >>> print(r2.status, r2.reason) -- cgit v0.12 From fd8d7e9b0dc151bd37da6756b09fa2d139416229 Mon Sep 17 00:00:00 2001 From: Senthil Kumaran Date: Sun, 19 Jun 2011 16:59:41 -0700 Subject: Whitespace nit fixed using reident. --- Doc/library/http.client.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst index d16b808..54873ae 100644 --- a/Doc/library/http.client.rst +++ b/Doc/library/http.client.rst @@ -545,7 +545,7 @@ statement. .. attribute:: HTTPResponse.closed - Is True if the stream is closed. + Is True if the stream is closed. Examples -------- -- cgit v0.12 From 5c0347b3989e7bf9fd78825a6bdd1fee7ad2a9dd Mon Sep 17 00:00:00 2001 From: Senthil Kumaran Date: Sun, 19 Jun 2011 17:37:06 -0700 Subject: Fix closes Issue12359 - Minor update to module import description. --- Doc/tutorial/modules.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/Doc/tutorial/modules.rst b/Doc/tutorial/modules.rst index d4bfbda..6239c2a 100644 --- a/Doc/tutorial/modules.rst +++ b/Doc/tutorial/modules.rst @@ -159,13 +159,14 @@ The Module Search Path .. index:: triple: module; search; path -When a module named :mod:`spam` is imported, the interpreter searches for a file -named :file:`spam.py` in the current directory, and then in the list of -directories specified by the environment variable :envvar:`PYTHONPATH`. This -has the same syntax as the shell variable :envvar:`PATH`, that is, a list of -directory names. When :envvar:`PYTHONPATH` is not set, or when the file is not -found there, the search continues in an installation-dependent default path; on -Unix, this is usually :file:`.:/usr/local/lib/python`. +When a module named :mod:`spam` is imported, the interpreter searches for a +file named :file:`spam.py` in the directory containing the input script (or +thecurrent directory), and then in the list of directories specified by the +environment variable :envvar:`PYTHONPATH`. This has the same syntax as the +shell variable :envvar:`PATH`, that is, a list of directory names. When +:envvar:`PYTHONPATH` is not set, or when the file is not found there, the +search continues in an installation-dependent default path; on Unix, this is +usually :file:`.:/usr/local/lib/python`. Actually, modules are searched in the list of directories given by the variable ``sys.path`` which is initialized from the directory containing the input script -- cgit v0.12