diff options
author | R David Murray <rdmurray@bitdance.com> | 2013-04-28 15:07:16 (GMT) |
---|---|---|
committer | R David Murray <rdmurray@bitdance.com> | 2013-04-28 15:07:16 (GMT) |
commit | 5aea37ad1dad0841ab6b5408156cff592fbfa310 (patch) | |
tree | b797422a9b99d0958bd1c86775d9bb03429522a9 /Doc/howto/urllib2.rst | |
parent | abac0a7744c6c317821935f86a342a44cba1aaaf (diff) | |
download | cpython-5aea37ad1dad0841ab6b5408156cff592fbfa310.zip cpython-5aea37ad1dad0841ab6b5408156cff592fbfa310.tar.gz cpython-5aea37ad1dad0841ab6b5408156cff592fbfa310.tar.bz2 |
#7152: Clarify that ProxyHandler is added only if proxy settings are detected.
Behavior confirmation and initial patch by Jessica McKellar.
Diffstat (limited to 'Doc/howto/urllib2.rst')
-rw-r--r-- | Doc/howto/urllib2.rst | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/Doc/howto/urllib2.rst b/Doc/howto/urllib2.rst index 955e455..77ef505 100644 --- a/Doc/howto/urllib2.rst +++ b/Doc/howto/urllib2.rst @@ -504,9 +504,10 @@ than the URL you pass to .add_password() will also match. :: In the above example we only supplied our ``HTTPBasicAuthHandler`` to ``build_opener``. By default openers have the handlers for normal situations - -- ``ProxyHandler``, ``UnknownHandler``, ``HTTPHandler``, + -- ``ProxyHandler`` (if a proxy setting such as an :envvar:`http_proxy` + environment variable is set), ``UnknownHandler``, ``HTTPHandler``, ``HTTPDefaultErrorHandler``, ``HTTPRedirectHandler``, ``FTPHandler``, - ``FileHandler``, ``HTTPErrorProcessor``. + ``FileHandler``, ``DataHandler``, ``HTTPErrorProcessor``. ``top_level_url`` is in fact *either* a full URL (including the 'http:' scheme component and the hostname and optionally the port number) @@ -521,7 +522,8 @@ Proxies ======= **urllib** will auto-detect your proxy settings and use those. This is through -the ``ProxyHandler`` which is part of the normal handler chain. Normally that's +the ``ProxyHandler``, which is part of the normal handler chain when a proxy +setting is detected. Normally that's a good thing, but there are occasions when it may not be helpful [#]_. One way to do this is to setup our own ``ProxyHandler``, with no proxies defined. This is done using similar steps to setting up a `Basic Authentication`_ handler : :: |