Commit aef0e890 authored by Fred Drake's avatar Fred Drake

Document the limitation that urllib does not work with proxies which

require authenication.  This is an implementation limitation rather than
required behavior, and may be fixed in the future.

This closes SourceForge bug #111725.
parent a54436fb
...@@ -62,11 +62,12 @@ If the \var{url} uses the \file{http:} scheme identifier, the optional ...@@ -62,11 +62,12 @@ If the \var{url} uses the \file{http:} scheme identifier, the optional
must in standard \file{application/x-www-form-urlencoded} format; must in standard \file{application/x-www-form-urlencoded} format;
see the \function{urlencode()} function below. see the \function{urlencode()} function below.
The \function{urlopen()} function works transparently with proxies. The \function{urlopen()} function works transparently with proxies
In a \UNIX{} or Windows environment, set the \envvar{http_proxy}, whicd do not require authentication. In a \UNIX{} or Windows
\envvar{ftp_proxy} or \envvar{gopher_proxy} environment variables to a environment, set the \envvar{http_proxy}, \envvar{ftp_proxy} or
URL that identifies the proxy server before starting the Python \envvar{gopher_proxy} environment variables to a URL that identifies
interpreter. For example (the \character{\%} is the command prompt): the proxy server before starting the Python interpreter. For example
(the \character{\%} is the command prompt):
\begin{verbatim} \begin{verbatim}
% http_proxy="http://www.someproxy.com:3128" % http_proxy="http://www.someproxy.com:3128"
...@@ -78,6 +79,9 @@ interpreter. For example (the \character{\%} is the command prompt): ...@@ -78,6 +79,9 @@ interpreter. For example (the \character{\%} is the command prompt):
In a Macintosh environment, \function{urlopen()} will retrieve proxy In a Macintosh environment, \function{urlopen()} will retrieve proxy
information from Internet\index{Internet Config} Config. information from Internet\index{Internet Config} Config.
Proxies which require authentication for use are not currently
supported; this is considered an implementation limitation.
The \function{urlopen()} function works transparently with proxies. The \function{urlopen()} function works transparently with proxies.
In a \UNIX{} or Windows environment, set the \envvar{http_proxy}, In a \UNIX{} or Windows environment, set the \envvar{http_proxy},
\envvar{ftp_proxy} or \envvar{gopher_proxy} environment variables to a \envvar{ftp_proxy} or \envvar{gopher_proxy} environment variables to a
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment