diff options
author | Benjamin Peterson <benjamin@python.org> | 2011-06-20 00:48:38 (GMT) |
---|---|---|
committer | Benjamin Peterson <benjamin@python.org> | 2011-06-20 00:48:38 (GMT) |
commit | 4092e68396e861ca57f1a5761e8a60d5ce300877 (patch) | |
tree | 9b23bac0df174fafc0206ae2ac589f1e90949fa9 | |
parent | f5ff22329b3a4838054dfadfad74fc5a0519cbb2 (diff) | |
parent | bd4c321a3f7664e22ead9ea8ec55c10c10583905 (diff) | |
download | cpython-4092e68396e861ca57f1a5761e8a60d5ce300877.zip cpython-4092e68396e861ca57f1a5761e8a60d5ce300877.tar.gz cpython-4092e68396e861ca57f1a5761e8a60d5ce300877.tar.bz2 |
merge heads
-rw-r--r-- | Doc/library/http.client.rst | 13 | ||||
-rw-r--r-- | Doc/tutorial/modules.rst | 15 |
2 files changed, 20 insertions, 8 deletions
diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst index 704585b..54873ae 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) diff --git a/Doc/tutorial/modules.rst b/Doc/tutorial/modules.rst index d4bfbda..2451fd5 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 +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`. 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 |