Merge: Reflow paragraphs.
(I got a merge conflict on this in urllib.request.rst, which makes no sense to me. Hopefully I didn't screw up the previous 3.3 commit.)
This commit is contained in:
commit
d4c1b36c39
|
@ -523,10 +523,10 @@ Proxies
|
||||||
|
|
||||||
**urllib** will auto-detect your proxy settings and use those. This is through
|
**urllib** will auto-detect your proxy settings and use those. This is through
|
||||||
the ``ProxyHandler``, which is part of the normal handler chain when a proxy
|
the ``ProxyHandler``, which is part of the normal handler chain when a proxy
|
||||||
setting is detected. Normally that's
|
setting is detected. Normally that's a good thing, but there are occasions
|
||||||
a good thing, but there are occasions when it may not be helpful [#]_. One way
|
when it may not be helpful [#]_. One way to do this is to setup our own
|
||||||
to do this is to setup our own ``ProxyHandler``, with no proxies defined. This
|
``ProxyHandler``, with no proxies defined. This is done using similar steps to
|
||||||
is done using similar steps to setting up a `Basic Authentication`_ handler : ::
|
setting up a `Basic Authentication`_ handler : ::
|
||||||
|
|
||||||
>>> proxy_support = urllib.request.ProxyHandler({})
|
>>> proxy_support = urllib.request.ProxyHandler({})
|
||||||
>>> opener = urllib.request.build_opener(proxy_support)
|
>>> opener = urllib.request.build_opener(proxy_support)
|
||||||
|
|
|
@ -129,10 +129,9 @@ The :mod:`urllib.request` module defines the following functions:
|
||||||
the constructor without any parameters). Instances of the following classes
|
the constructor without any parameters). Instances of the following classes
|
||||||
will be in front of the *handler*\s, unless the *handler*\s contain them,
|
will be in front of the *handler*\s, unless the *handler*\s contain them,
|
||||||
instances of them or subclasses of them: :class:`ProxyHandler` (if proxy
|
instances of them or subclasses of them: :class:`ProxyHandler` (if proxy
|
||||||
settings are detected),
|
settings are detected), :class:`UnknownHandler`, :class:`HTTPHandler`,
|
||||||
:class:`UnknownHandler`, :class:`HTTPHandler`, :class:`HTTPDefaultErrorHandler`,
|
:class:`HTTPDefaultErrorHandler`, :class:`HTTPRedirectHandler`,
|
||||||
:class:`HTTPRedirectHandler`, :class:`FTPHandler`, :class:`FileHandler`,
|
:class:`FTPHandler`, :class:`FileHandler`, :class:`HTTPErrorProcessor`.
|
||||||
:class:`HTTPErrorProcessor`, :class:`DataHandler`.
|
|
||||||
|
|
||||||
If the Python installation has SSL support (i.e., if the :mod:`ssl` module
|
If the Python installation has SSL support (i.e., if the :mod:`ssl` module
|
||||||
can be imported), :class:`HTTPSHandler` will also be added.
|
can be imported), :class:`HTTPSHandler` will also be added.
|
||||||
|
@ -257,12 +256,12 @@ The following classes are provided:
|
||||||
.. class:: ProxyHandler(proxies=None)
|
.. class:: ProxyHandler(proxies=None)
|
||||||
|
|
||||||
Cause requests to go through a proxy. If *proxies* is given, it must be a
|
Cause requests to go through a proxy. If *proxies* is given, it must be a
|
||||||
dictionary mapping protocol names to URLs of proxies. The default is to read the
|
dictionary mapping protocol names to URLs of proxies. The default is to read
|
||||||
list of proxies from the environment variables :envvar:`<protocol>_proxy`.
|
the list of proxies from the environment variables
|
||||||
If no proxy environment variables are set, then in a Windows environment proxy
|
:envvar:`<protocol>_proxy`. If no proxy environment variables are set, then
|
||||||
settings are obtained from the registry's Internet Settings section, and in a
|
in a Windows environment proxy settings are obtained from the registry's
|
||||||
Mac OS X environment proxy information is retrieved from the OS X System
|
Internet Settings section, and in a Mac OS X environment proxy information
|
||||||
Configuration Framework.
|
is retrieved from the OS X System Configuration Framework.
|
||||||
|
|
||||||
To disable autodetected proxy pass an empty dictionary.
|
To disable autodetected proxy pass an empty dictionary.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue