a

q�dgx
�@sdZd
dl
mZmZmZmZ
d
dlmZmZm	Z	m
Z
mZmZm
Z
mZ
d
dlmZmZmZ
d
dlZd
dlZd
dlZd
dlZd
dlmZ
d
dlmZ
dd	lmZmZmZ
dd
l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1
ddl2m3Z3m4Z4
d
dl5Z5d
dl6Z6d
dl7Z7d
dl8Z8d
dl9Z9d
dl:Z:d
dl;Z;d
dl<Z<d
dl=Z=d
dl>Z>d
dlmZ
e�
rpd
d
l?m@Z@
nd
d
lAm@Z@
zd
dlBZBd
dlBmCZC
WneD�
y�


dZEYn0dZEgd�
ZFe:jGdd�ZHdaIde9jJfdd�
ZKdd�ZLgZMd�dd�
ZNdd�ZOe�re8�Pde8jQ�ZRn
e8�Pd�
ZRdd�ZSGdd�deT�ZUGd d!�d!eT�ZVd"d#�ZWGd$d%�d%eT�ZXGd&d'�d'eX�ZYGd(d)�d)eX�ZZGd*d+�d+eX�Z[d,d-�Z\Gd.d/�d/eX�Z]Gd0d1�d1eT�Z^Gd2d3�d3e^�Z_Gd4d5�d5eT�Z`Gd6d7�d7e`eX�ZaGd8d9�d9e`eX�Zbe6jcZdGd:d;�d;eT�ZeGd<d=�d=eXee�ZfGd>d?�d?eXee�ZgGd@dA�dAeX�ZhGdBdC�dCeh�ZiejedD��rvGdEdF�dFeh�ZkeF�ldF�

GdGdH�dHeX�ZmGdIdJ�dJeX�ZndKdL�ZodMdN�ZpGdOdP�dPeX�ZqdQdR�ZrGdSdT�dTeX�ZsGdUdV�dVes�ZtdWZue6jvdXk�rd
dYlwmxZxmyZy
ndZd[�Zxd\d]�ZyiZzGd^d_�d_eT�Z{Gd`da�dae{�Z|da}dbdc�Z~daddde�Z�da�dfdg�Z�da�dhdi�Z�Gdjdk�dkeT�Z�dldm�Z�dndo�Z�dpdq�Z�e:j�drk�r�d
dsl�m�Z�m�Z�
dtdu�Z�dvdw�Z�dxdy�Z�dzd{�Z�n6e6jvdXk�r�d|d}�Z�d~d{�Z�dd��Z�d�dy�Z�ne�Z�e�Z�dS)�a�

Ported using Python-Future from the Python 3.3 standard library.

An extensible library for opening URLs using a variety of protocols

The simplest way to use this module is to call the urlopen function,
which accepts a string containing a URL or a Request object (described
below).  It opens the URL and returns the results as file-like
object; the returned object has some extra methods described below.

The OpenerDirector manages a collection of Handler objects that do
all the actual work.  Each Handler implements a particular protocol or
option.  The OpenerDirector is a composite object that invokes the
Handlers needed to open the requested URL.  For example, the
HTTPHandler performs HTTP GET and POST requests and deals with
non-error returns.  The HTTPRedirectHandler automatically deals with
HTTP 301, 302, 303 and 307 redirect errors, and the HTTPDigestAuthHandler
deals with digest authentication.

urlopen(url, data=None) -- Basic usage is the same as original
urllib.  pass the url and optionally data to post to an HTTP URL, and
get a file-like object back.  One difference is that you can also pass
a Request instance instead of URL.  Raises a URLError (subclass of
IOError); for HTTP errors, raises an HTTPError, which can also be
treated as a valid response.

build_opener -- Function that creates a new OpenerDirector instance.
Will install the default handlers.  Accepts one or more Handlers as
arguments, either instances or Handler classes that it will
instantiate.  If one of the argument is a subclass of the default
handler, the argument will be installed instead of the default.

install_opener -- Installs a new opener as the default opener.

objects of interest:

OpenerDirector -- Sets up the User Agent as the Python-urllib client and manages
the Handler classes, while dealing with requests and responses.

Request -- An object that encapsulates the state of a request.  The
state can be as simple as the URL.  It can also include extra HTTP
headers, e.g. a User-Agent.

BaseHandler --

internals:
BaseHandler and parent
_call_chain conventions

Example usage:

import urllib.request

# set up authentication info
authinfo = urllib.request.HTTPBasicAuthHandler()
authinfo.add_password(realm='PDQ Application',
                      uri='https://mahler:8092/site-updates.py',
                      user='klem',
                      passwd='geheim$parole')

proxy_support = urllib.request.ProxyHandler({"http" : "http://ahad-haam:3128"})

# build a new opener that adds authentication and caching FTP handlers
opener = urllib.request.build_opener(proxy_support, authinfo,
                                     urllib.request.CacheFTPHandler)

# install it
urllib.request.install_opener(opener)

f = urllib.request.urlopen('http://www.python.org/')
�)�absolute_import�division�print_function�unicode_literals)�bytes�dict�filter�input�int�map�open�str)�PY2�PY3�raise_with_tracebackN)
�email)
�client�
)�URLError�	HTTPError�ContentTooShortError)�urlparse�urlsplit�urljoin�unwrap�quote�unquote�	splittype�	splithost�	splitport�	splituser�splitpasswd�	splitattr�
splitquery�
splitvalue�splittag�to_bytes�
urlunparse)�
addinfourl�addclosehook)
r)
�Iterable)
�
SSLContextFT)�Request�OpenerDirector�BaseHandler�HTTPDefaultErrorHandler�HTTPRedirectHandler�HTTPCookieProcessor�ProxyHandler�HTTPPasswordMgr�HTTPPasswordMgrWithDefaultRealm�AbstractBasicAuthHandler�HTTPBasicAuthHandler�ProxyBasicAuthHandler�AbstractDigestAuthHandler�HTTPDigestAuthHandler�ProxyDigestAuthHandler�HTTPHandler�FileHandler�
FTPHandler�CacheFTPHandler�UnknownHandler�HTTPErrorProcessor�urlopen�install_opener�build_opener�pathname2url�url2pathname�
getproxies�urlretrieve�
urlcleanup�	URLopener�FancyURLopener�c
Ks�d
|vr|d
}|d
=nd}d|vr4|d}|d=nd}d|vrP|d}|d=nd}|s`|s`|r�tslt
d�
�
t�tj�
}|jtjO_tj|_|s�|r�|�	||�
n|�
�
t|dd�}t|�
}	nt
dur�t�a
}	nt
}	|	�||
|�S)N�	cadefaultF�capath�cafilezSSL support not availableT��context�check_hostname)�	_have_ssl�
ValueError�sslr+�PROTOCOL_SSLv23�options�OP_NO_SSLv2�
CERT_REQUIRED�verify_mode�load_verify_locations�set_default_verify_paths�HTTPSHandlerrC�_openerr)
�url�data�timeoutZ_3to2kwargsrLrMrNrP�
https_handler�opener�rc�I/usr/local/lib/python3.9/site-packages/future/backports/urllib/request.pyrA�s*


















rAc


Cs|adS�
N)
r])
rbrcrcrdrB�srBc	Csl
t|�
\}}t
�t||��
�
�}|��}|d
krR|
sRtj�|�
|fWd�
S|
rbt|
d�}nt	j
dd�
}|j}
t�
|
�

|��
|
|f}	d}
d}d}d}
d	|vr�t|d
�
}|r�||
|
|�
|�|
�
}|sҐ
q|t|�
7}|�|�

|
d7}
|r�||
|
|�
q�Wd�
n1�
s0


Y
Wd�
n1�
s80


Y
|dk�
rh||k�
rhtd||f|	��
|	S)
aW
    Retrieve a URL into a temporary location on disk.

    Requires a URL argument. If a filename is passed, it is used as
    the temporary file location. The reporthook argument should be
    a callable that accepts a block number, a read size, and the
    total file size of the URL target. The data argument should be
    valid URL encoded data.

    If a filename is passed and the URL points to a local resource,
    the result is a copy from local file to new file.

    Returns a tuple containing the path to the newly created
    data file as well as the resulting HTTPMessage object.
    �fileN�wbF)
�delete� ���r
�content-length�Content-Lengthr�1retrieval incomplete: got only %i out of %i bytes)r�
contextlib�closingrA�info�os�path�normpathr�tempfile�NamedTemporaryFile�name�_url_tempfiles�appendr
�read�len�writer)r^�filename�
reporthookr_�url_typerr�fp�headers�tfp�result�bs�sizery�blocknum�blockrcrcrdrG�sH






















N


�
�rGc
	CsBtD]&}zt
�|�

Wqty(


Yq0qtdd�=tr>dadSre)rwrq�unlink�EnvironmentErrorr])
�	temp_filercrcrdrH�s






rHz:\d+$c
Cs<|j}
t
|
�
d
}|dkr&|�dd�}t�d|d
�}|��S)z�Return request-host, as defined by RFC 2965.

    Variation from RFC: returned value is lowercased, for convenient
    comparison.

    r��Host)�full_urlr�
get_header�_cut_port_re�sub�lower)�requestr^�hostrcrcrd�request_host
s



r�c@s�eZ
dZd
id
dd
fdd�
Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd)d%d&�
Zd'd(�Zd
S)*r,NFc	Cs�t|
�
|_
t|j
�
\|_
|_||_i|_d|_|��D]\}}|�||�
q6i|_	|durbt
|�
}||_||_||_
|��
dSre)rr�r%�fragmentr_r��_tunnel_host�items�
add_header�unredirected_hdrsr��origin_req_host�unverifiable�method�_parse)	�selfr^r_r�r�r�r��key�valuercrcrd�__init__
s













zRequest.__init__c
CsNt|j
�
\|_}
|jdur(td
|j
�
�
t|
�
\|_|_|jrJt|j�
|_dS)Nzunknown url type: %r)rr��typerSrr��selectorr)r��restrcrcrdr�.
s






zRequest._parsec

Cs&|jd
u
r|jS|j
d
u
rdSdSd
S)z3Return a string indicating the HTTP request method.N�POST�GET)r�r_�
r�rcrcrd�
get_method6
s





zRequest.get_methodc

Cs |jrd
|j
|jfS|j
SdS)Nz%s#%s)r�r�r�rcrcrd�get_full_url?
s

zRequest.get_full_urlcCsd
}tj
|tdd�
|
|_dS)Nz&Request.add_data method is deprecated.r�
�
stacklevel��warnings�warn�DeprecationWarningr_)r�r_�msgrcrcrd�add_dataG
s


zRequest.add_datac
Csd
}
tj
|
tdd�
|jdu
S)Nz&Request.has_data method is deprecated.rr�r��r�r�rcrcrd�has_dataL
s


zRequest.has_datac
Csd
}
tj
|
tdd�
|jS)Nz&Request.get_data method is deprecated.rr�r�r�rcrcrd�get_dataQ
s


zRequest.get_datac
Csd
}
tj
|
tdd�
|jS)Nz&Request.get_type method is deprecated.rr�)r�r�r�r�r�rcrcrd�get_typeV
s


zRequest.get_typec
Csd
}
tj
|
tdd�
|jS)Nz&Request.get_host method is deprecated.rr�)r�r�r�r�r�rcrcrd�get_host[
s


zRequest.get_hostc
Csd
}
tj
|
tdd�
|jS)Nz*Request.get_selector method is deprecated.rr�)r�r�r�r�r�rcrcrd�get_selector`
s


zRequest.get_selectorc
Csd
}
tj
|
tdd�
|jS)Nz-Request.is_unverifiable method is deprecated.rr�)r�r�r�r�r�rcrcrd�is_unverifiablee
s


zRequest.is_unverifiablec
Csd
}
tj
|
tdd�
|jS)Nz1Request.get_origin_req_host method is deprecated.rr�)r�r�r�r�r�rcrcrd�get_origin_req_hostj
s


zRequest.get_origin_req_hostcCs2|jd
kr|j
s|j|_
n||_|j|_|
|_dS)N�https)r�r�r�r�r�)r�r�r�rcrcrd�	set_proxyq
s





zRequest.set_proxyc

Cs|j|j
kSre)r�r�r�rcrcrd�	has_proxyy
s
zRequest.has_proxycCs||j|
�
�<dSre)r��
capitalize�r�r��valrcrcrdr�|
szRequest.add_headercCs||j|
�
�<dSre)r�r�r�rcrcrd�add_unredirected_header�
szRequest.add_unredirected_headercCs|
|jvp|
|j
vSre)r�r�)r��header_namercrcrd�
has_header�
s


�zRequest.has_headercCs|j�
|
|j�
|
|��Sre)r��getr�)r�r��defaultrcrcrdr��
s


�zRequest.get_headerc
Cs"|j�
�}
|
�|j�

t|
���
Sre)r��copy�updater��listr�)r��hdrsrcrcrd�header_items�
s



zRequest.header_items)
N)�__name__�
__module__�__qualname__r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rcrcrcrdr,
s,

�
	
r,c@sNeZ
dZd
d�Zdd�Zdd�Zdd�Zd	ejfd
d�
Z	ddd
�
Z
dd�Zd	S)r-c
Cs6d
t}
d|
fg
|_
g|_i|_i|_i|_i|_dS)N�Python-urllib/%sz
User-agent)�__version__�
addheaders�handlers�handle_open�handle_error�process_response�process_request)r��client_versionrcrcrdr��
s




zOpenerDirector.__init__c	CsR
t|
d
�st
dt|
�
�
�
d}t|
�
D�
]}|dvr6q&|�d�
}|d|�}||dd�}|�d�
r�|�d�
|d}||dd�}zt|�
}Wnty�


Yn0|j�	|i�}	|	|j|<n>|dkr�|}|j
}	n*|d	kr�|}|j}	n|d
kr&|}|j}	nq&|	�
|g�}
|
�
r t�|
|
�
n
|
�|
�

d}q&|�
rNt�|j|
�
|
�|�

dS)N�
add_parentz%expected BaseHandler instance, got %rF)�redirect_request�do_open�
proxy_open�
_r�errorr�responser�T)�hasattr�	TypeErrorr��dir�find�
startswithr
rSr�r�r�r�r��
setdefault�bisect�insortrxr�r�)r��handler�added�meth�
i�protocol�	condition�
j�kind�lookupr�rcrcrd�add_handler�
sL



�




























zOpenerDirector.add_handlerc


CsdSrercr�rcrcrd�close�
szOpenerDirector.closec	Gs<|
�|d
�}|D]&}t
||�}||�}|du
r|
SqdS)Nrc)r��getattr)	r��chainr��	meth_name�argsr�r��funcr�rcrcrd�_call_chain�
s





zOpenerDirector._call_chainNc
Cs�t|
t
�r|
��}
t|
t�r(t|
|�}n|
}|d
u
r:||_||_|j}|d}|j�	|g�D]}t
||�}||�
}q\|�||�}	|d}|j�	|g�D]}t
||�}|||	�}	q�|	S)z�
        Accept a URL or a Request object

        Python-Future: if the URL is passed as a byte-string, decode it first.
        N�_request�	_response)
�
isinstancer�decoder
r,r_r`r�r�r�r��_openr�)
r��fullurlr_r`�reqr�r��	processorr�r�rcrcrdr�
s&
















zOpenerDirector.opencCsP|�|j
d
d|
�}|r|S|
j}|�|j
||d|
�}|r>|S|�|j
dd|
�S)Nr��default_openr��unknown�unknown_open)r�r�r�)r�r�r_r�r�rcrcrdr��
s 


�


�
�


�zOpenerDirector._opencGs~|
d
vr,|jd}|d}
d|
}d}|}n|j}|
d}d}||
|f|}|j
|�}|r^|S|rz|dd	f|}|j
|�SdS)
N��httpr�r

�z
http_error_%sr�_errorr
r��http_error_default)r�r�)r��protor�rr��http_err�	orig_argsr�rcrcrdr�
s 














zOpenerDirector.error)
N)r�r�r�r�r�r�r��socket�_GLOBAL_DEFAULT_TIMEOUTrr�r�rcrcrcrdr-�
s
/"
r-cGs�d
d�}
t�}t
tttttttg}t	t
d�r6|�t�

t
�}|D]@}|D]6}|
|�
rjt||�r~|�|�

qHt||�rH|�|�

qHq@|D]}|�|�

q�|D]}|�|��

q�|D]}|
|�
r�|�}|�|�

q�|S)a*
Create an opener object from a list of handlers.

    The opener will use several default handlers, including support
    for HTTP, FTP and when applicable HTTPS.

    If any of the handlers passed as arguments are subclasses of the
    default handlers, the default handlers will not be used.
    c

Sst|t
�pt|d
�S)N�	__bases__)r�r�r�)
�objrcrcrd�isclass/s
zbuild_opener.<locals>.isclass�HTTPSConnection)r-r2r?r;r/r0r=r<r@r��http_clientrxr\�set�
issubclass�addr��remover�)r�r
rb�default_classes�skip�klass�check�
hrcrcrdrC&s2	


�



















rCc@s(eZ
dZd
Zdd�Zdd�Zdd�ZdS)	r.��
cCs
|
|_dSre)
�parent)r�r
rcrcrdr�Os
zBaseHandler.add_parentc


CsdSrercr�rcrcrdr�RszBaseHandler.closecCst|
d
�sdS|j
|
j
kS)N�
handler_orderT)r�r
)r��otherrcrcrd�__lt__Vs


zBaseHandler.__lt__N)r�r�r�r
r�r�r
rcrcrcrdr.Ls
r.c@s eZ
dZd
ZdZdd�ZeZdS)r@zProcess HTTP error responses.i�cCsH|j|j
|��}}}d
|k
r,dksDn
|j�d|
||||�}|S)N���,
r

)�coder�rpr
r�)r�r�r�r
r�r�rcrcrd�
http_responsecs


�z HTTPErrorProcessor.http_responseN)r�r�r��__doc__r
r 
�https_responsercrcrcrdr@_s

r@c@seZ
dZd
d�ZdS)r/cCst|
j
||||��
dSre)rr�)r�r�rr
r�r�rcrcrdr
qs
z*HTTPDefaultErrorHandler.http_error_defaultN)r�r�r�r
rcrcrcrdr/ps
r/c@s4eZ
dZd
ZdZdd�Zdd�ZeZZZ	dZ
dS)	r0��
c	sx|
��}|d
vr|dvs:|dvr(|dks:t
|
j||||��
|�dd�}d�t�f
dd	�|
j��D�
�
}t|||
jd
d�S)a�
Return a Request or None in response to a redirect.

        This is called by the http_error_30x methods when a
        redirection response is received.  If a redirection should
        take place, return a new Request to allow http_error_30x to
        perform the redirect.  Otherwise, raise HTTPError if no-one
        else should try to handle this url.  Return None if you can't
        but another Handler might.
        )�-
�.
�/
i3
)r��HEAD)r%
r&
r'
r��
 z%20)rkzcontent-typec
3s&|]\}
}|
���v
r|
|fV
qdSre)
r���.0�
k�
v�
�CONTENT_HEADERSrcrd�	<genexpr>�s

�z7HTTPRedirectHandler.redirect_request.<locals>.<genexpr>T)r�r�r�)	r�rr��replacerr�r�r,r�)	r�r�rr
r�r��newurl�
m�
newheadersrcr.
rdr�|s


�
�




�z$HTTPRedirectHandler.redirect_requestc
Cs2
d
|vr|d
}nd|vr$|d}ndSt|�
}|j
dv
rRt||d||f||��
|jsht|�
}d|d<t|�
}t|
j|�}|�|
|||||�}|dur�dSt	|
d�r�|
j
}	|_
|	�|d�|jks�t
|	�
|jkr�t|
j||j|||��
ni}	|_
|
_
|	�|d�d	|	|<|��
|��
|jj||
jd
�S)N�location�uri�r

r��ftpr�z+%s - Redirection to url '%s' is not allowed�
/r
�
redirect_dictr
r�
r`)r�schemerrrr�r'rr�r�r�r:
r��max_repeatsrz�max_redirections�inf_msgryr�r
rr`)
r�r�rr
r�r�r2
�urlparts�new�visitedrcrcrd�http_error_302�sB










�








�
�

z"HTTPRedirectHandler.http_error_302zoThe HTTP server returned a redirect error that would lead to an infinite loop.
The last 30x error message was:
N)r�r�r�r=
r>
r�rC
�http_error_301�http_error_303�http_error_307r?
rcrcrcrdr0ts"7r0c
	Cs�t|�
\}
}|�
d
�
s d}
|}n:|�
d�
s6td|�
�
|�d
d�}|dkrNd}|d|�}t|�
\}}|du
r|t|�
\}}nd}}|
|||fS)a3Return (scheme, user, password, host/port) given a URL or an authority.

    If a URL is supplied, it must have an authority (host:port) component.
    According to RFC 3986, having an authority component means the URL must
    have two slashes after the scheme:

    >>> _parse_proxy('file:/ftp.example.com/')
    Traceback (most recent call last):
    ValueError: proxy URL with no authority: 'file:/ftp.example.com/'

    The first three items of the returned tuple may be None.

    Examples of authority parsing:

    >>> _parse_proxy('proxy.example.com')
    (None, None, None, 'proxy.example.com')
    >>> _parse_proxy('proxy.example.com:3128')
    (None, None, None, 'proxy.example.com:3128')

    The authority component may optionally include userinfo (assumed to be
    username:password):

    >>> _parse_proxy('joe:password@proxy.example.com')
    (None, 'joe', 'password', 'proxy.example.com')
    >>> _parse_proxy('joe:password@proxy.example.com:3128')
    (None, 'joe', 'password', 'proxy.example.com:3128')

    Same examples, but with URLs instead:

    >>> _parse_proxy('http://proxy.example.com/')
    ('http', None, None, 'proxy.example.com')
    >>> _parse_proxy('http://proxy.example.com:3128/')
    ('http', None, None, 'proxy.example.com:3128')
    >>> _parse_proxy('http://joe:password@proxy.example.com/')
    ('http', 'joe', 'password', 'proxy.example.com')
    >>> _parse_proxy('http://joe:password@proxy.example.com:3128')
    ('http', 'joe', 'password', 'proxy.example.com:3128')

    Everything after the authority is ignored:

    >>> _parse_proxy('ftp://joe:password@proxy.example.com/rubbish:3128')
    ('ftp', 'joe', 'password', 'proxy.example.com')

    Test for no trailing '/' case:

    >>> _parse_proxy('http://joe:password@proxy.example.com')
    ('http', 'joe', 'password', 'proxy.example.com')

    r9
N�//zproxy URL with no authority: %rr
rj)rr�rSr�r r!)	�proxyr<
�r_scheme�	authority�end�userinfo�hostport�user�passwordrcrcrd�_parse_proxy�s2











rP
c@s"eZ
dZd
Zddd�
Zdd�ZdS)r2�dNcCsZ|
durt�}
t
|
d
�s Jd�
�
|
|_|
��D]&\}}t|d||||jfdd�
�
q.dS)N�keys�proxies must be a mappingz%s_opencSs|||
|�Srerc)�
rrH
r�r�rcrcrd�<lambda>/s
z'ProxyHandler.__init__.<locals>.<lambda>)rFr��proxiesr��setattrr�)r�rV
r�r^rcrcrdr�(s







�zProxyHandler.__init__cCs�|
j}t
|�
\}}}}|dur"|}|
jr6t|
j�
r6dS|rv|rvd
t|�
t|�
f}	t�|	���
�d�
}
|
�	dd|
�
t|�
}|
�
||�
||ks�|dkr�dS|jj|
|
j
d�SdS)N�%s:%s�ascii�Proxy-authorization�Basic r�r;
)r�rP
r��proxy_bypassr�base64�	b64encode�encoder�r�r�r
rr`)r�r�rH
r��	orig_type�
proxy_typerN
rO
rM
�	user_pass�credsrcrcrdr�2s"






�



zProxyHandler.proxy_open)
N)r�r�r�r
r�r�rcrcrcrdr2$s

r2c@s6eZ
dZd
d�Zdd�Zdd�Zd
dd	�
Zd
d�ZdS)r3c

Cs
i|_dSre)
�passwdr�rcrcrdr�Ps
zHTTPPasswordMgr.__init__cs\t|t
�r|g
}|
�
jv
r$i�
j|
<d
D].�t��
fdd�|D�
�
}||f�
j|
|<q(dS)N�TFc
sg|]}
�
�|
���qSrc)
�
reduce_uri)r+
�
u��default_portr�rcrd�
<listcomp>[�z0HTTPPasswordMgr.add_password.<locals>.<listcomp>)r�r
rd
�tuple)r��realmr6
rN
rd
�reduced_urircrh
rd�add_passwordSs








�zHTTPPasswordMgr.add_passwordc	Cs`|j�
|
i�}d
D]H}|�||�}|��D].\}}|D] }|�||�r6|


Sq6q*qdS)Nre
�NN)rd
r�rf
r��	is_suburi)	r�rm
�authuri�domainsri
�reduced_authuri�uris�authinfor6
rcrcrd�find_user_password^s







z"HTTPPasswordMgr.find_user_passwordTc
Cs�t|
�
}|d
r.|d}|d
}|dp*d}nd}|
}d}t
|�
\}}|r~|dur~|du
r~ddd��|�
}	|	du
r~d	||	f}||fS)
z@Accept authority or URI and extract only the authority and path.rr
r
r9
N�Pi�
r
z%s:%d)rrr�)
r�r6
ri
�partsr<
rJ
rrr��port�dportrcrcrdrf
hs$








��

zHTTPPasswordMgr.reduce_uricCsR|
|krd
S|
d|dkr dSt�
|
d|df�
}t|�
t|
d�
krNd
SdS)zcCheck if test is below base in a URI tree

        Both args must be URIs in reduced form.
        Tr
Fr)�	posixpath�commonprefixrz)r��base�test�commonrcrcrdrq
s






zHTTPPasswordMgr.is_suburiN)
T)r�r�r�r�ro
rw
rf
rq
rcrcrcrdr3Ns


r3c@seZ
dZd
d�ZdS)r4cCs0t�
||
|�\}}|du
r"||fSt�
|d|�Sre)r3rw
)r�rm
rr
rN
rO
rcrcrdrw
�s

�

z2HTTPPasswordMgrWithDefaultRealm.find_user_passwordN)r�r�r�rw
rcrcrcrdr4�sr4c@s<eZ
dZe�d
ej�Zddd�
Zdd�Zdd�Z	d	d
�Z
dS)r5z1(?:.*,)*[ 	]*([^ 	]+)[ 	]+realm=(["']?)([^"']*)\2NcCs(|
durt�}
|
|_
|j
j|_d
|_dS�Nr
)r3rd
ro
�retried)r��password_mgrrcrcrdr��s






z!AbstractBasicAuthHandler.__init__c

Cs
d
|_dSr�
�
r�
r�rcrcrd�reset_retry_count�s
z*AbstractBasicAuthHandler.reset_retry_countc
Cs�|�|
d�}
|j
d
kr,t|��dd|d��
n|j
d7_
|
r�|
��d}|��dkrdtd|�
�
nftj�	|
�
}|r�|�
�\}}}|dv
r�t�d	t
d
�
|��dkr�|�|||�}	|	r�|	jdkr�d|_
|	SdS)N��
zbasic auth failedrr
�basiczDAbstractBasicAuthHandler does not support the following scheme: '%s')�
"�
'zBasic Auth Realm was unquotedr
)r�r�
rr��splitr�rSr5�rx�search�groupsr�r��UserWarning�retry_http_basic_authr
)
r��authreqr�r�r�r<
�morrm
r�rcrcrd�http_error_auth_reqed�s0

�


�




�



z.AbstractBasicAuthHandler.http_error_auth_reqedcCs~|j�
||
�\}}|du
rvd
||f}dt�|���
�d�
}|j�|jd�|krVdS|�	|j|�
|j
j||jd�SdSdS)NrX
r[
rY
r;
)
rd
rw
r]
r^
r_
r�r�r��auth_headerr�r
rr`)r�r�r�rm
rN
�pw�raw�authrcrcrdr�
�s







z.AbstractBasicAuthHandler.retry_http_basic_auth)
N)r�r�r��re�compile�
Ir�
r�r�
r�
r�
rcrcrcrdr5�s
�
 r5c@seZ
dZd
Zdd�ZdS)r6�
AuthorizationcCs"|
j}|�
d
||
|�}|��
|S)N�www-authenticate)r�r�
r�
)r�r�rr
r�r�r^r�rcrcrd�http_error_401�s


�
z#HTTPBasicAuthHandler.http_error_401N)r�r�r�r�
r�
rcrcrcrdr6�sr6c@seZ
dZd
Zdd�ZdS)r7rZ
cCs"|
j}|�
d
||
|�}|��
|S�N�proxy-authenticate�r�r�
r�
)r�r�rr
r�r�rJ
r�rcrcrd�http_error_407�s

�
z$ProxyBasicAuthHandler.http_error_407N)r�r�r�r�
r�
rcrcrcrdr7�sr7c@sNeZ
dZddd�
Zdd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
d
S)r8NcCs4|
durt�}
|
|_
|j
j|_d
|_d
|_d|_dSr�
)r3rd
ro
r�
�nonce_count�
last_nonce)r�rd
rcrcrdr�s







z"AbstractDigestAuthHandler.__init__c

Cs
d
|_dSr�
r�
r�rcrcrdr�
s
z+AbstractDigestAuthHandler.reset_retry_countcCs||�|
d�}|j
d
kr*t|jdd|d��
n|j
d7_
|rx|��d}|��dkr`|�||�S|��dkrxtd|�
�
dS)	Nr�
r�
zdigest auth failedrr
�digestr�
zEAbstractDigestAuthHandler does not support the following scheme: '%s')r�r�
rr�r�
r��retry_http_digest_authrS)r�r�
r�r�r�r�
r<
rcrcrdr�
s




�






�z/AbstractDigestAuthHandler.http_error_auth_reqedcCsz|�d
d�\}}t
tdt|�
��
}|�|
|�}|rvd|}|
j�|jd�|krRdS|
�|j|�
|j	j
|
|
jd�}|SdS)Nr)
rz	Digest %sr;
)r�
�parse_keqv_listr�parse_http_list�get_authorizationr�r�r�
r�r
rr`)r�r�r�
�token�	challenge�chal�auth_val�resprcrcrdr�
(s









z0AbstractDigestAuthHandler.retry_http_digest_authcCs@d
|j|
t
��f}|�d�
td�
}t�|�
��}|dd�S)Nz	%s:%s:%s:rY
��)r�
�time�ctimer_
�_randombytes�hashlib�sha1�	hexdigest)r��nonce�
s�
b�digrcrcrd�
get_cnonce4s


z$AbstractDigestAuthHandler.get_cnoncecCs�
z6|d
}|d}|�d�
}|�dd�}|�dd�}Wnt
yJ


YdS0|�|�
\}}	|durfdS|j�||
j�\}
}|
dur�dS|
jdu
r�|�|
j|�}nd}d|
||f}
d|
��|
j	f}|d	k�
r.||j
kr�|jd
7_nd
|_||_
d|j}|�|�
}d||||||�
f}|	||
�
|�}n2|du�
rT|	||
�
d|||�
f�}nt
d
|�
�
d|
|||
j	|f}|�
r�|d|7}|�
r�|d|7}|d|7}|�
r�|d||f7}|S)Nrm
r�
�qop�	algorithm�MD5�opaquez%s:%s:%srX
r�
rz%08xz%s:%s:%s:%s:%szqop '%s' is not supported.z>username="%s", realm="%s", nonce="%s", uri="%s", response="%s"z
, opaque="%s"z
, digest="%s"z, algorithm="%s"z, qop=auth, nc=%s, cnonce="%s")r��KeyError�get_algorithm_implsrd
rw
r�r_�get_entity_digestr�r�r�
r�
r�
r)r�r�r�
rm
r�
r�
r�
r�
�
H�KDrN
r�
�entdig�A1�A2�ncvalue�cnonce�noncebit�respdigr~
rcrcrdr�
?s\














�
















��






z+AbstractDigestAuthHandler.get_authorizationcs6|
d
krdd��n|
dkr"dd���f
dd�}�|fS)Nr�
c

Sst�
|�d
�
�
��S�NrY
)r�
�md5r_
r�
�
�
xrcrcrdrU
~rk
z?AbstractDigestAuthHandler.get_algorithm_impls.<locals>.<lambda>�SHAc

Sst�
|�d
�
�
��Sr�
)r�
r�
r_
r�
r�
rcrcrdrU
�rk
cs�d
||
f�
S)NrX
rc)r�
�
d�
r�
rcrdrU
�rk
rc)r�r�
r�
rcr�
rdr�
{s




z-AbstractDigestAuthHandler.get_algorithm_implsc
CsdSrerc)r�r_r�
rcrcrdr�
�sz+AbstractDigestAuthHandler.get_entity_digest)
N)r�r�r�r�r�
r�
r�
r�
r�
r�
r�
rcrcrcrdr8�s
	<
r8c@s eZ
dZd
ZdZdZdd�ZdS)r9z�An authentication protocol defined by RFC 2069

    Digest authentication improves on basic authentication because it
    does not transmit passwords in the clear.
    r�
��
cCs*t|
j
�
d
}|�d||
|�}|��
|S)Nrr�
)rr�r�
r�
�r�r�rr
r�r�r��retryrcrcrdr�
�s


�
z$HTTPDigestAuthHandler.http_error_401N)r�r�r�r!
r�
r
r�
rcrcrcrdr9�s

r9c@seZ
dZd
ZdZdd�ZdS)r:�Proxy-Authorizationr�
cCs"|
j}|�
d
||
|�}|��
|Sr�
r�
r�
rcrcrdr�
�s


�
z%ProxyDigestAuthHandler.http_error_407N)r�r�r�r�
r
r�
rcrcrcrdr:�s
r:c@s.eZ
dZddd�
Zdd�Zdd�Zdd	�Zd
S)�AbstractHTTPHandlerr
cCs
|
|_dSre�
�_debuglevel)r��
debuglevelrcrcrdr��s
zAbstractHTTPHandler.__init__cCs
|
|_dSrer�
)r��levelrcrcrd�set_http_debuglevel�s
z'AbstractHTTPHandler.set_http_debuglevelc
CsN
|
j}|st
d
�
�
|
jdu
r�|
j}t|t�r8d}t|�
�
|
�d�
sN|
�dd�
|
�d�
s�d}z:tr~t|t	j	�r~t
|�
|j}nt|�
}t
|�
|j}Wn0ty�


t|t
�r�tdt|�
|f�
�
Yn0|
�dd|�
|}|
��r�t|
j�
\}}	t|	�
\}}
|
�d�
�
s|
�d|�
|jjD]*\}}|��}|
�|�
�
s|
�||�
�
q|
S)	N�
no host givenzLPOST data should be bytes or an iterable of bytes. It cannot be of type str.zContent-type�!application/x-www-form-urlencodedzContent-lengthzBContent-Length should be specified for iterable data of type %r %rz%dr�)r�rr_r�r
r�r�r�r�arrayrz�itemsize�
memoryviewr*rSr�r�rr�rr
r�r�)
r�r�r�r_r�r��mv�sel_hostr<
�sel�sel_pathrvr�rcrcrd�do_request_�sR












�









��
�








zAbstractHTTPHandler.do_request_c

s4
|j}|st
d
�
�
|
|f
d|ji
|�
�
}t|j�
���t�f
dd�|j��D�
�
�

d�d<tdd����D�
�
�|jr�i}d}|�vr��|||<�|=|j	|j|d	�
z|�
|��|j|j
��
Wn6tjy�
}
z|��
t
|�
�
WYd
}~n*d
}~00|��}	|j�
r|j��
d
|_|��|	_|	j|	_|	S)z�Return an HTTPResponse object for the request, using http_class.

        http_class must implement the HTTPConnection API from http.client.
        r�
r`c
3s"|]\}
}|
�v
r|
|fV
qdSrercr*
�
r�rcrdr0
�s

�z.AbstractHTTPHandler.do_open.<locals>.<genexpr>r��
Connectionc
ss|]\}
}|
��|fV
qdSre)
�title)r+
rvr�rcrcrdr0
�rk
r�
r�
N)r�rr`rr�r�r�r�r��
set_tunnelr�r�r�r_r
r�r��getresponse�sockr�r^�reasonr�)
r��
http_classr��http_conn_argsr�r
�tunnel_headers�proxy_auth_hdr�errrT
rcr�
rdr��s6



"














zAbstractHTTPHandler.do_openN)
r
)r�r�r�r�r�
r�
r�rcrcrcrdr�
�s
3r�
c@seZ
dZd
d�ZejZdS)r;cCs|�t
j|
�Sre)r�r
�HTTPConnection�r�r�rcrcrd�	http_open$s
zHTTPHandler.http_openN)r�r�r�r�
r�
r�
�http_requestrcrcrcrdr;"sr;r

c@s$eZ
dZddd�
Zdd�ZejZdS)r\r
NcCst�
||
�
||_||_dSre)r�
r��_context�_check_hostname)r�r�
rPrQrcrcrdr�-s


zHTTPSHandler.__init__cCs|jt
j|
|j|jd
�S)NrO)r�r
r

r�
r�
r�
rcrcrd�
https_open2s


�zHTTPSHandler.https_open)r
NN)r�r�r�r�r�
r�
r�
�
https_requestrcrcrcrdr\+s
r\c@s.eZ
dZddd�
Zdd�Zdd�ZeZeZd
S)	r1NcCs2d
dlm

m
m}
|
dur(|��}
|
|_dSr�
)Zfuture.backports.http.cookiejar�	backportsr

�	cookiejar�	CookieJar)r�r�
�http_cookiejarrcrcrdr�;s



zHTTPCookieProcessor.__init__cCs|j�
|
�

|
Sre)r�
�add_cookie_header)r�r�rcrcrdr�
As

z HTTPCookieProcessor.http_requestcCs|j�
||
�
|Sre)r�
�extract_cookies)r�r�r�rcrcrdr 
Es

z!HTTPCookieProcessor.http_response)
N)r�r�r�r�r�
r 
r�
r"
rcrcrcrdr1:s



r1c@seZ
dZd
d�ZdS)r?cCs|
j}t
d
|�
�
dS)Nzunknown url type: %s)r�r)r�r�r�rcrcrdr�Ms

zUnknownHandler.unknown_openN)r�r�r�r�rcrcrcrdr?Ls
r?c
CsNi}
|D]@}|�d
d�\}}|ddkr@|ddkr@|dd�}||
|<q|
S)z>Parse list of key=value strings where keys are not duplicated.�
=rr
r�
rj)
r�
)�
l�parsed�eltr,
r-
rcrcrdr�
Qs






r�
c
Cs�g}
d
}d}}|D]l}|r*||7}d}q|rT|dkr>d}qn|dkrJd}||7}q|dkrl|
�|�

d
}q|dkrxd}||7}q|r�|
�|�

dd�|
D�
S)	ap
Parse lists as described by RFC 2068 Section 2.

    In particular, parse comma-separated lists where the elements of
    the list may include quoted-strings.  A quoted-string could
    contain a comma.  A non-quoted string could have quotes in the
    middle.  Neither commas nor quotes count if they are escaped.
    Only double-quotes count, not single-quotes.
    r�F�
\Tr�
�
,c
Ssg|]}
|
���qSrc�
�strip)r+
�partrcrcrdrj
�rk
z#parse_http_list.<locals>.<listcomp>)
rx)r�
�resr�escaper�currcrcrdr�
[s4	





















r�
c@s(eZ
dZd
d�ZdZdd�Zdd�ZdS)r<cCs\|
j}|dd
�dkrN|d
d�dkrN|
j
rN|
j
dkrN|
j
|��u
rXtd�
�
n
|�|
�
SdS)Nr
rG
rKr9
�	localhost�-file:// scheme is supported only on localhost)r�r��	get_namesr�open_local_file)r�r�r^rcrcrd�	file_open�s

&
�

zFileHandler.file_openNc

Cs^tj
durXz*tt�d
�
dt�t���
d�
t_
Wn"tjyV


t�d
�
f
t_
Yn0tj
S)Nrr
)r<�namesrl
r
�gethostbyname_ex�gethostname�gaierror�
gethostbynamer�rcrcrdr�s





��


zFileHandler.get_namesc
Cs
d
dlm

m
m}
d
dl}|
j}|
j}t|�
}z�t�	|�
}|j
}|j|jdd�}	|�
|�
d
}
t�d|
ppd||	f�
}|r�t|�
\}}|r�|s�t|�
|��vr�|r�d||}
nd|}
tt|d�||
�WSWn.t�
y
}
zt|�
�
WYd}~n
d}~00td�
�
dS)	Nr
T�
�usegmtz6Content-type: %s
Content-length: %d
Last-modified: %s
�
text/plain�file://�rbzfile not on local host)�future.backports.email.utilsr�
r�utils�	mimetypesr�r�rErq�stat�st_size�
formatdate�st_mtime�
guess_type�message_from_stringr�_safe_gethostbynamerr(r�OSErrorr)r�r��email_utilsrr�r|�	localfile�statsr��modified�mtyper�rz
�origurl�exprcrcrdr�s:













��


�
�



zFileHandler.open_local_file)r�r�r�rrrrrcrcrcrdr<�s

r<c

Cs(zt�
|�
WStjy"


YdS0dSre)r
rr�
r�rcrcrdr$�s



r$c@seZ
dZd
d�Zdd�ZdS)r=c
Cs&d
dl}d
dl
}|
j}|s"td�
�
t|�
\}}|dur>|j}nt|�
}t|�
\}}|rdt|�
\}}nd}t	|�
}|pvd}|p~d}zt
�|�
}Wn.t
jy�
}
zt|�
�
WYd}~n
d}~00t
|
j�
\}	}
|	�d�
}ttt	|��
}|dd�|d}}|�
r|d
�
s|dd�}z�|�||||||
j�}
|�
r:d�
p<d}|
D]2}t|�
\}}|��d	k�
rB|d
v�
rB|��}�
qB|
�||�\}}d}|�|
j�
d
}|�
r�|d|7}|du
�
r�|d
k�
r�|d|7}t�|�
}t|||
j�WS|j�y 
}
z td
|�
}t|�

WYd}~n
d}~00dS)Nr
�ftp error: no host givenr�r9
rjrr�
�
Dr���
a�
Ar�r�
r�
r/zContent-type: %s
zContent-length: %d
�
ftp error: %r)�ftplibrr�rr�FTP_PORTr
r r!rr
rr�r"r�r�
r�r�connect_ftpr`r$r��upper�retrfiler"r�rr#r(�
all_errorsr)r�r�r4rr�rz
rN
rd
r�rr�attrs�dirsrf�fwr��attrr�r�retrlenr�r*r,�excrcrcrd�ftp_open�s^





























�












zFTPHandler.ftp_openc	Cst|
|||||d
d�S)NF)
�
persistent)
�
ftpwrapper)r�rN
rd
r�rz
r;r`rcrcrdr6�s

�zFTPHandler.connect_ftpN)r�r�r�r@r6rcrcrcrdr=�s
5r=c@s<eZ
dZd
d�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
S)r>c

Cs"i|_i|_
d
|_d|_d|_dS)Nr
�<r�
)�cacher`�soonest�delay�	max_connsr�rcrcrdr��s





zCacheFTPHandler.__init__cCs
|
|_dSre)
rF)r��
trcrcrd�
setTimeouts
zCacheFTPHandler.setTimeoutcCs
|
|_dSre)
rG)r�r3
rcrcrd�setMaxConnss
zCacheFTPHandler.setMaxConnscCsr|
||d
�|�
|f}||j
vr4t��|j|j|<n,t|
|||||�|j
|<t��|j|j|<|��
|j
|S)Nr9
)�joinrDr�
rFr`rB�check_cache)r�rN
rd
r�rz
r;r`r�rcrcrdr6
s





�


zCacheFTPHandler.connect_ftpc
Cs�t��}
|j
|
k
rPt|j���
D].\}}||
kr |j|��
|j|=|j|=q tt|j���
�
|_
t	|j�
|j
kr�t|j���
D]&\}}||j
kr�|j|=|j|=
q�q�tt|j���
�
|_
dSre)r�
rEr�r`r�rDr��min�valuesrzrG)r�rHr,
r-
rcrcrdrLs















zCacheFTPHandler.check_cachec
Cs0|j�
�D]}
|
��
q
|j��
|j��
dSre)rDrNr��clearr`)r��connrcrcrd�clear_cache)s





zCacheFTPHandler.clear_cacheN)	r�r�r�r�rIrJr6rLrQrcrcrcrdr>�sr>r$
�nt)rErDc

Cst|�
S)
zOS-specific conversion from a relative URL of the 'file' scheme
        to a file system path; not recommended for general use.)
r�
�pathnamercrcrdrE8srEc

Cst|�
S)
zOS-specific conversion from a file system path to a relative URL
        of the 'file' scheme; not recommended for general use.)
rrSrcrcrdrD=srDc@s�eZ
dZd
ZdZdeZd*dd�
Zdd�Zdd	�Z	d
d�Z
dd
�Zd+dd�
Zd,dd�
Z
d-dd�
Zd.dd�
Zdd�Zd/dd�
Zd0dd�
Zdd�Zer�dd�Zd1d d!�
Zd"d#�Zd$d%�Zd&d'�Zd2d(d)�
ZdS)3rIa,
Class to open URLs.
    This is a class rather than just a subroutine because we may need
    more than one set of global protocol-specific options.
    Note -- this is a base class for those who don't want the
    automatic handling of errors type 302 (relocated) and 401
    (authorization needed).Nr�cKs�d
d|jj
i
}tj|tdd�
|
dur.t�}
t|
d�s@Jd�
�
|
|_|�d�
|_	|�d�
|_
d	|jfg
|_g|_
tj|_d|_t|_dS)
NzW%(class)s style of invoking requests is deprecated. Use newer urlopen functions/methods�classrKr�rR
rS
�key_file�	cert_filez
User-Agent)�	__class__r�r�r�r�rFr�rV
r�rVrW�versionr��_URLopener__tempfilesrqr��_URLopener__unlink�	tempcache�ftpcache)r�rV
�x509r�rcrcrdr�Ws


�









zURLopener.__init__c

Cs|��
dSre)
r�r�rcrcrd�__del__qs
zURLopener.__del__c

Cs|��
dSre)
�cleanupr�rcrcrdr�ts
zURLopener.closec
	CsT|jr@|jD]&}
z|�
|
�

Wqty0


Yq0q|jdd�=|jrP|j��
dSre)rZr[r%r\rO)r�rfrcrcrdr`ws








zURLopener.cleanupc
Gs|j�
|
�

d
S)zdAdd a header to be used by the HTTP interface only
        e.g. u.addheader('Accept', 'sound/basic')N)r�rx)r�r�rcrcrd�	addheader�szURLopener.addheaderc
CsZ
tt
|
�
�
}
t|
d
d�}
|jrL|
|jvrL|j|
\}}t|d�}t|||
�St|
�
\}}|s`d}||jvr�|j|}t|�
\}}	t|	�
\}
}|
|
f}nd}d|}||_	|�
dd�}t||�s�|r�|�||
|�S|�
|
|�Sz.|dur�t||�|�
WSt||�||�WSWnJt�
y 


�Yn6tj�
yT
}

zttd	|
��

WYd}
~
n
d}
~
00dS)
z6Use URLopener().open(file) instead of open(file, 'r').z%/:=&?~#+!$,;'@()*[]|�
�saferrfN�open_�
-r�zsocket error)rr&rr\rr(rrV
rr�r1
r��open_unknown_proxy�open_unknownr�rr
r�r�IOError)r�r�r_r|r�r�urltyper^rH
�	proxyhostr�r�rvr�rcrcrdr�s<






























zURLopener.opencCst|
�
\}}t
d
d|��
dS)�/Overridable interface to open unknown URL type.�	url errorzunknown url typeN�rrh)r�r�r_r�r^rcrcrdrg�s
zURLopener.open_unknowncCs t|�
\}}t
d
d||
��
dS)rkrlzinvalid proxy for %sNrm)r�rH
r�r_r�r^rcrcrdrf�s
zURLopener.open_unknown_proxyc
Cs6tt
|
�
�
}
|jr&|
|jvr&|j|
St|
�
\}}|d
ur�|rF|dkr�z0|�|�
}|��}|��
tt|�
d�
|fWSt	y�
}	
zWYd
}	~	n
d
}	~	00|�
|
|�}�
zV|��}
|r�t
|d�}n|dd
l}t|
�
\}
}t|p�d�
\}
}t|p�d�
\}}
t
|�
pd�
\}}
tj�|�
d}|�|�
\}}|j�|�

t�|d�}z�||
f}|jd
u
�
r`||j|
<d}d}d}d}d	|
v�
r�t|
d
�
}|�
r�||||�
|�|�
}|�
s��
q�|t|�
7}|�|�

|d7}|�
r�||||�
�
q�W|��
n
|��
0W|��
n
|��
0|dk�r2||k�r2td||f|��
|S)ztretrieve(url) returns (filename, headers) for a local object
        or (tempfilename, headers) for a remote object.Nrfrrgr
r�rirjrkrlrm)rr&r\rrrpr�rErrhrrtr#r"rqrr�splitext�mkstemprZrx�fdopenr
ryrzr{r)r�r^r|r}r_r��url1rr�r�r�r�rt�garbagerr�suffix�fdr�r�r�ryr�r�rcrcrd�retrieve�sp



















































�
�zURLopener.retrievecCs d
}d
}t|t
�r<t|�
\}}|r6t|�
\}}t|�
}|}nt|\}}t|�
\}}t|�
\}	}
|
}d
}|	��dkrvd
}n:t|
�
\}}
|r�t|�
\}}|r�d|	||
f}t|�
r�|}|s�tdd��
|r�t|�
}t	�
|���
�d�
}nd
}|�
rt|�
}t	�
|���
�d�
}nd
}|
|�
}
i}|�
r*d||d<|�
r<d||d	<|�
rJ||d
<d|d<|j
D]\}}|||<�
qX|d
u
�
r�d
|d<|
�d|||�
n|
jd||d�
z|
��}Wntj�
y�


td�
�
Yn0d|jk
�
r�dk�rn
nt||jd||j�S|�||j|j|j|j|�Sd
S)a�
Make an HTTP connection using connection_class.

        This is an internal method that should be called from
        open_http() or open_https().

        Arguments:
        - connection_factory should take a host name and return an
          HTTPConnection instance.
        - url is the url to retrieval or a host, relative-path pair.
        - data is payload for a POST request or None.
        Nr

z	%s://%s%sz
http errorr�
rY
zBasic %sr�
r�
r�r�r�
r�
zContent-Typer�r�r�
z$http protocol error: bad status liner
r
�http:)r�r
rr rrr�r\
rhr]
r^
r_
r�r�r�r�
r
�
BadStatusLiner�statusr(r��
http_errorrr�
)r��connection_factoryr^r_�user_passwd�proxy_passwdr�r��realhostrir��
proxy_authr�
�	http_connr��headerr�r�rcrcrd�_open_generic_http�st






































�

�zURLopener._open_generic_httpcCs|�t
j|
|�S)
zUse HTTP protocol.)r�r
r�
�r�r^r_rcrcrd�	open_httpXszURLopener.open_httpc
Csbd
|}t||�rPt
||�}|dur6||
||||�}	n||
|||||�}	|	rP|	S|�|
||||�S)z�Handle http errors.

        Derived class can override this, or provide specific handlers
        named http_error_DDD where DDD is the 3-digit error code.z
http_error_%dN)r�r�r
)
r�r^r�errcode�errmsgr�r_rvr�r�rcrcrdry\s







zURLopener.http_errorcCs|��
t
|
|||d
��
d
S)z>Default error handler: close the connection and raise IOError.N)r�r�r�r^rr�r�r�rcrcrdr
ls
zURLopener.http_error_defaultcCstj
|
|j|jd
�S)N)rVrW)r
r

rVrW)r�r�rcrcrd�_https_connectionrs


�zURLopener._https_connectioncCs|�|j
|
|�S)
zUse HTTPS protocol.)r�r�r�rcrcrd�
open_httpswszURLopener.open_httpscCs^t|
t
�std
�
�
|
dd�dkrP|
dd�dkrP|
dd���dkrPtd	�
�
n
|�|
�
SdS)
z/Use local file or FTP depending on form of URL.zEfile error: proxy support for file protocol currently not implementedNr
rG
rKr9
�z
localhost/r
)r�r
rr�rSr)r�r^rcrcrd�	open_file{s



4

zURLopener.open_filec
Csl
d
dlm

m
m}
d
dl}t|
�
\}}t|�
}zt�|�
}Wn2t	yt
}
zt
|j|j��
WYd}~n
d}~00|j
}	|j|jdd�}
|�|
�
d
}t�d|p�d|	|
f�
}|s�|}
|dd�dkr�d	|}
tt|d
�||
�St|�
\}}|�
s`t�|�
t�f
t�v�
r`|}
|dd�dk�
r0d	|}
n|dd�dk�
rNtd
|
�
�
tt|d
�||
�St
d�
�
dS)zUse local file.r
NTrz6Content-Type: %s
Content-Length: %d
Last-modified: %s
rrr9
rrr
z./zAlocal file url may start with / or file:. Unknown url of type: %sz#local file error: not on local host)rr�
rrrrrErqrr%r�strerrorr|rr r!r"r#r(rrr
rr�thishostrS)r�r^r&rr�rf�	localnamer(�
er�r)r*r��urlfilerz
rcrcrdr�s@






$





��






�






zURLopener.open_local_filec
Cs�t|
t
�std
�
�
ddl}t|
�
\}}|s2td�
�
t|�
\}}t|�
\}}|r\t|�
\}}nd}t|�
}t|ppd�
}t|p|d�
}t	�
|�
}|s�ddl}|j}nt
|�
}t|�
\}}	t|�
}|�d�
}
|
dd�|
d}
}|
r�|
ds�|
dd�}
|
�
r
|
d�
s
d|
d<|||d�|
�
f}t|j�
tk�
rb|j��D]*}
|
|k�
r6|j|
}|j|
=|��
�
q6z�||jv
�
r�t|||||
�|j|<|�
s�d	}nd
}|	D]2}t|�
\}}|��dk�
r�|dv�
r�|��}�
q�|j|�||�\}}|�d
|
�
d}d}|�r|d|7}|du
�r,|dk�r,|d|7}t�|�
}t||d
|
�WSt��y~
}
zt td|�
�

WYd}~n
d}~00dS)zUse FTP protocol.zCftp error: proxy support for ftp protocol currently not implementedr
Nr.r�r9
rjrr/r�
r�r0zftp:zContent-Type: %s
zContent-Length: %d
zftp error %r)!r�r
rrrrr r!rr
rr4r5r
r"r�
rKrzr]�MAXFTPCACHErR
r�rBr$r�r7r8r"rr#r(�	ftperrorsr)r�r^rr�rrrz
rN
rd
r4r:r;rfr�r,
r-
r�r=r�rr>r*r�r,rcrcrd�open_ftp�sj
































�




�











zURLopener.open_ftpc	
Cs:
t|
t
�std
�
�
z|
�dd�\}}WntyB


tdd��
Yn0|sLd}|�d�
}|dkr�d	||d
�v
r�||dd
�}|d
|�}nd}g}|�dt�	d
t�
t���
��

|�d|�

|dkr�t�|�
d�
�
�d�
}nt|�
}|�dt|�
�

|�d�

|�|�

d�|�
}t�|�
}t�|�
}t|||
�S)zUse "data" URL.zEdata error: proxy support for data protocol currently not implementedrrz
data errorzbad data URLztext/plain;charset=US-ASCII�
;r
rNr�zDate: %sz%a, %d %b %Y %H:%M:%S GMTzContent-type: %sr]
rY
zlatin-1zContent-Length: %d�

)r�r
rr�
rSrh�rfindrxr�
�strftime�gmtimer]
�decodebytesr_
r�rrzrKrr#�io�StringIOr()	r�r^r_r��semi�encodingr�r��
frcrcrd�	open_data�s8














�











zURLopener.open_data)
N)
N)
N)
N)NNN)
N)
N)
N)
N)r�r�r�r!
rZr�rYr�r_r�r`rarrgrfrur�r�ryr
rRr�r�r�rr�r�rcrcrcrdrIJs.


$


B\



	 :rIc@s�eZ
dZd
Zdd�Zdd�Zd#dd�
Zd	d
�Zd$dd�
Zd%d
d�
Z	d&dd�
Z
d'dd�
Zd(dd�
Zd)dd�
Z
d*dd�
Zd+dd�
Zd,dd�
Zd-dd �
Zd!d"�ZdS).rJz?Derived class with handlers for errors we can handle (perhaps).c
Os.tj
|g
|
�
Ri|�
�

i|_d
|_d|_dS)Nr
r$
)rIr��
auth_cache�tries�maxtries)r�r��kwargsrcrcrdr�s



zFancyURLopener.__init__cCst||d
|
|�S)z3Default error handling -- don't raise an exception.rv)
r(r�rcrcrdr
sz!FancyURLopener.http_error_defaultNc	Csl|jd
7_|j
rN|j|j
krNt|d�r2|j}n|j}d|_||
|dd|�S|�|
|||||�}d|_|S)z%Error 302 -- relocated (temporarily).r�http_error_500r
r
z)Internal Server Error: Redirect Recursion)r�r�r�r�r
�redirect_internal)	r�r^rr�r�r�r_r�r�rcrcrdrC
s






�
�
zFancyURLopener.http_error_302c	Csxd
|vr|d
}nd|vr$|d}ndS|��
t
|jd|
|�}t|�
}|jdv
rnt|||d|||��
|�|�
S)Nr5
r6
�
:r7
z( Redirection to url '%s' is not allowed.)r�rr�rr<
rr)	r�r^rr�r�r�r_r2
r@
rcrcrdr�%s 










��z FancyURLopener.redirect_internalcCs|�|
|||||�S)
z*Error 301 -- also relocated (permanently).�
rC
�r�r^rr�r�r�r_rcrcrdrD
AszFancyURLopener.http_error_301cCs|�|
|||||�S)
z;Error 303 -- also relocated (essentially identical to 302).r�r�rcrcrdrE
EszFancyURLopener.http_error_303cCs2|d
ur|�|
|||||�S|�
|
||||�Sd
S)z1Error 307 -- relocated, but turn POST into error.N)rC
r
r�rcrcrdrF
Is
zFancyURLopener.http_error_307Fc
Cs�d
|v
rt�
||
||||�
|d
}t�d|�}	|	sHt�
||
||||�
|	��\}
}|
��dkrtt�
||
||||�
|s�t�
||
||||�
d|jd}|dur�t||�|
|�St||�|
||�SdS)z_Error 401 -- authentication required.
        This function supports Basic authentication only.r�
�![ 	]*([^ 	]+)[ 	]+realm="([^"]*)"r�
�retry_�_basic_authN�rIr
r�
�matchr�
r�r�r��
r�r^rr�r�r�r_r�
�stuffr�r<
rm
rvrcrcrdr�
Ps.


�




�



�

�

zFancyURLopener.http_error_401c
Cs�d
|v
rt�
||
||||�
|d
}t�d|�}	|	sHt�
||
||||�
|	��\}
}|
��dkrtt�
||
||||�
|s�t�
||
||||�
d|jd}|dur�t||�|
|�St||�|
||�SdS)zeError 407 -- proxy authentication required.
        This function supports Basic authentication only.r�
r�r�
�retry_proxy_r�Nr�r�rcrcrdr�
is.


�




�



�

�

zFancyURLopener.http_error_407cCs�t|
�
\}}d
||}|j
d}t|�
\}}	t|	�
\}	}
|	�d�
d}|	|d�}	|�|	||�\}}
|sr|
srdSdt|dd�t|
dd�|	f}	d
|	|
|j
d<|dur�|�|�
S|�||�SdS)N�http://r

�
@r�%s:%s@%sr�rb�rrV
rr��get_user_passwdrr�r�r^rm
r_r�r�r2
rH
rirj�
proxyselectorr�rN
rd
rcrcrd�retry_proxy_http_basic_auth�s 











�


z*FancyURLopener.retry_proxy_http_basic_authcCs�t|
�
\}}d
||}|j
d}t|�
\}}	t|	�
\}	}
|	�d�
d}|	|d�}	|�|	||�\}}
|sr|
srdSdt|dd�t|
dd�|	f}	d
|	|
|j
d<|dur�|�|�
S|�||�SdS)N�https://r�r�rr�r�rbr�r�rcrcrd�retry_proxy_https_basic_auth�s 











�


z+FancyURLopener.retry_proxy_https_basic_authc
Cs�t|
�
\}}|�
d
�
d}||d�}|�|||�\}}|sD|sDdSdt|dd�t|dd�|f}d||}	|dur�|�|	�
S|�|	|�SdS)Nr�rr�r�rbr��rr�r�rr�
r�r^rm
r_r�r�r�rN
rd
r2
rcrcrdr�
�s






�


z$FancyURLopener.retry_http_basic_authc
Cs�t|
�
\}}|�
d
�
d}||d�}|�|||�\}}|sD|sDdSdt|dd�t|dd�|f}d||}	|dur�|�|	�
S|�|	|�SdS)Nr�rr�r�rbr�r�r�rcrcrd�retry_https_basic_auth�s






�


z%FancyURLopener.retry_https_basic_authr
cCs`|d
|
��}||j
vr2|r(|j
|=n
|j
|S|�|
|�\}}|sJ|rX||f|j
|<||fS)Nr�)r�r��prompt_user_passwd)r�r�rm
rQr�rN
rd
rcrcrdr��s









zFancyURLopener.get_user_passwdcCsVd
dl}z.t
d||
f�
}|�d|||
f�
}||fWStyP


t�
YdS0dS)z#Override this in a GUI environment!r
NzEnter username for %s at %s: z#Enter password for %s in %s at %s: rp
)�getpassr	�KeyboardInterrupt�print)r�r�rm
r�rN
rd
rcrcrdr��s



�



z!FancyURLopener.prompt_user_passwd)
N)
N)
N)
N)NF)NF)
N)
N)
N)
N)
r
)r�r�r�r!
r�r
rC
r�rD
rE
rF
r�
r�
r�r�r�
r�r�r�rcrcrcrdrJs(





�

�





rJcCstd
urt
�d�
atS)z8Return the IP address of the magic hostname 'localhost'.Nr)�
_localhostr
rrcrcrcrdr�s


rcCsNtd
urJzt
t�t���
d�
aWn&tjyH


t
t�d�
d�
aYn0tS)z,Return the IP addresses of the current host.Nr
r)�	_thishostrl
r
rrrrcrcrcrdr��s




r�c
Cstd
urdd
l
}|jatS)z1Return the set of errors raised by the FTP class.Nr
)�
_ftperrorsr4r9)
r4rcrcrdr��s


r�cCstd
urt
�d�
atS)z%Return an empty email Message object.Nr�)�
_noheadersrr#rcrcrcrd�	noheaders�s


r�c@sJeZ
dZd
Zddd�
Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dS)rBz;Class used by open_ftp() for cache of open FTP connections.NTcCs<|
|_||_
||_||_||_||_d
|_||_|��
dSr�
)	rN
rd
r�rz
r;r`�refcount�	keepalive�init)r�rN
rd
r�rz
r;r`rArcrcrdr�	s







zftpwrapper.__init__c
Cs\d
dl}
d
|_
|
��|_|j�|j|j|j�
|j�|j	|j
�
d�|j�
}|j�
|�

dS)Nr
r9
)r4�busy�FTPr8
�connectr�rz
r`�loginrN
rd
rKr;�cwd)r�r4�_targetrcrcrdr�	s







zftpwrapper.initc
Cs�
d
dl}|�
�
|dvr"d}d}nd|}d
}z|j�|�

Wn(|jyf


|��
|j�|�

Yn0d}|
r�|s�zd|
}|j�|�
\}}WnJ|jy�
}
z0t|�
dd�dkr�t	t
d	|�
�

WYd}~n
d}~00|�
s�|j�d�

|
�
rx|j��}	z`z|j�|
�

Wn>|j�
yN
}
z"t
d	|�
}
||
_
|
�
WYd}~n
d}~00W|j�|	�

n|j�|	�

0d
|
}nd}|j�|�
\}}d|_t|�d�
|j�}|jd7_|��
||fS)
Nr
)r�
r/zTYPE ArzTYPE zRETR rK�550r3zLIST �LISTr)r4�endtransferr8
�voidcmdr9r��ntransfercmd�
error_permr
rr�pwdr��	__cause__r�r)�makefile�
file_closer�r�)r�rfr�r4�cmd�isdirrPr>r�
r�r?�ftpobjrcrcrdr8	sJ















&














zftpwrapper.retrfilec

Cs
d
|_dSr�
)
r�r�rcrcrdr�K	s
zftpwrapper.endtransferc

Csd
|_|j
dk
r|��
dS)NFr
)r�r��
real_closer�rcrcrdr�N	s



zftpwrapper.closec

Cs2|��
|j
d
8_
|j
dk
r.|js.|��
dS)Nrr
)r�r�r�r�r�rcrcrdr�S	s



zftpwrapper.file_closec

Cs0|��
z|j
��
Wnt�y*


Yn0dSre)r�r8
r�r�r�rcrcrdr�Y	s





zftpwrapper.real_close)NT)r�r�r�r!
r�r�r8r�r�r�r�rcrcrcrdrB	s

�
	0rBcCsHi}tj
��D]4\}
}|
��}
|r|
d
d�dkr|||
dd
�<q|S)a
Return a dictionary of scheme -> proxy server URL mappings.

    Scan the environment for variables named <scheme>_proxy;
    this seems to be the standard convention.  If you need a
    different way, you can pass a proxies dictionary to the
    [Fancy]URLopener constructor.

    i����N�_proxy)rq�environr�r�)rV
rvr�rcrcrd�getproxies_environmenta	s	




r�c
Csttj
�d
d�ptj
�dd�}
|
dkr(dSt|�
\}}dd�|
�d�
D�
}|D]"}|rL|�|�
sh|�|�
rL
dSqLd	S)
z�Test if proxies should not be used for a particular host.

    Checks the environment for a variable named no_proxy, which should
    be a list of DNS suffixes separated by commas, or '*' for all hosts.
    �no_proxyr�ZNO_PROXY�
*rc
Ssg|]}
|
���qSrcr)r+
rH
rcrcrdrj
~	rk
z,proxy_bypass_environment.<locals>.<listcomp>rr
)rqr�r�rr�
�endswith)r�r��hostonlyrz
Z
no_proxy_listrvrcrcrd�proxy_bypass_environmentq	s



r�c	Cs
d
dlm}
t
|�
\}}dd�}d|v
r4|
dr4dSd}|
�d	d
�D]�}|sNqDt�d|�}|du
�
r|dur�zt�|�
}||�
}Wntjy�


YqDYn0||�d�
�
}	|�d
�
}
|
dur�d|�d�
�	d�
d}
nt
|
dd��
}
d|
}
||
?|	|
?k�
r
dSqD|||�rD
dSqDdS)aj

    Return True iff this host shouldn't be accessed using a proxy

    This function uses the MacOSX framework SystemConfiguration
    to fetch the proxy information.

    proxy_settings come from _scproxy._get_proxy_settings or get mocked ie:
    { 'exclude_simple': bool,
      'exceptions': ['foo.bar', '*.bar.com', '127.0.0.1', '10.1', '10.0/16']
    }
    r
)
�fnmatchc
Ssd|�d
�
}
t
tt|
��
}
t|
�
dkr8|
gd�
dd�}
|
dd>|
dd>B|
dd	>B|
d
BS)N�
.r#
)r
r
r
r
r
�rr�
r
r�
rK)r�
r�rr
rz)�ipAddrry
rcrcrd�ip2num�	s






z,_proxy_bypass_macosx_sysconf.<locals>.ip2numr��exclude_simpleTN�
exceptionsrcz(\d+(?:\.\d+)*)(/\d+)?rr
r�
� F)r�rr�r�
r�r
rr��group�countr
)r��proxy_settingsr�r�rz
r��hostIPr�r3
r~
�maskrcrcrd�_proxy_bypass_macosx_sysconf�	s8



















r��darwin)�_get_proxy_settings�_get_proxiesc
Cst�}
t
||
�Sre)r�r�)r�r�rcrcrd�proxy_bypass_macosx_sysconf�	s

r�c
Cst�S)
z�Return a dictionary of scheme -> proxy server URL mappings.

        This function uses the MacOSX framework SystemConfiguration
        to fetch the proxy information.
        )
r�rcrcrcrd�getproxies_macosx_sysconf�	sr�c

Cst�rt
|�
St|�
SdSre)r�r�r�r-rcrcrdr\
�	s

r\
c
Cst�p
t
�Sre)r�r�rcrcrcrdrF�	s
rFc
Cs
i}zd
dl}
Wnt
y&


|YS0z�|
�|
jd�}|
�|d�d
}|r�t|
�|d�d
�
}d|vr�|�d�
D]4}|�dd�\}}t�d	|�s�d
||f}|||<qrn>|dd�dkr�||d
<n$d||d
<d||d<d||d<|�	�
Wnt
ttf�
y


Yn0|S)zxReturn a dictionary of scheme -> proxy server URL mappings.

        Win32 uses the registry to store proxies.

        r
N�;Software\Microsoft\Windows\CurrentVersion\Internet Settings�ProxyEnableZProxyServerrr�rz^([^/:]+)://z%s://%sr�
rvr

z	http://%sz
https://%sr�zftp://%sr8
)
�winreg�ImportError�OpenKey�HKEY_CURRENT_USER�QueryValueExr
r�
r�
r��Close�WindowsErrorrSr�)rV
r��internetSettings�proxyEnableZproxyServer�
pr��addressrcrcrd�getproxies_registry�	sF






�
�
�
�
�









rc
Cst�p
t
�S)
��Return a dictionary of scheme -> proxy server URL mappings.

        Returns settings gathered from the environment, if specified,
        or the registry.

        )r�rrcrcrcrdrF
sc
Csv
zd
dl}
Wnt
y 


Yd
S0z6|
�|
jd�}|
�|d�d
}t|
�|d�d
�
}Wntyl


Yd
S0|rv|szd
St|�
\}}|g
}z t�	|�
}||kr�|�
|�

Wntjy�


Yn0z t�|�
}||kr�|�
|�

Wntjy�


Yn0|�
d�
}|D]j}	|	dk�
r$d|v
�
r$
dS|	�dd	�}	|	�d
d�}	|	�dd�}	|D] }
t�|	|
tj��
rL

dS�
qL�
qd
S)
Nr
r�r�Z
ProxyOverrider�z<local>r�rz\.r�z.*�
?)r�r�r�r�r�r
rrr
rrxr��getfqdnr�
r1
r�
r�r�
)r�r�r
rZ
proxyOverrideZrawHostrz
�addrZfqdnr
r�rcrcrd�proxy_bypass_registry
s`





�
�
�
�
�































r
c

Cst�rt
|�
St|�
Sd
S)rN)r�r�r
r-rcrcrdr\
H
s
)NNN)�r!
�
__future__rrrrZfuture.builtinsrrrr	r
rrr
Zfuture.utilsrrrr]
r�r�
r�
Zfuture.backportsrZfuture.backports.httprr
r�rrr�parserrrrrrrrrr r!r"r#r$r%r&r'r�r(r)r�rqr|
r�
r
�sysr�
rtrnr��collectionsr*�collections.abcrTr+r�rR�__all__rYr�r]r	
rArBrwrGrHr�
�ASCIIr�r��objectr,r-rCr.r@r/r0rP
r2r3r4r5r6r7�urandomr�
r8r9r:r�
r;r�r\rxr1r?r�
r�
r<r$r=r>r�rvZ
nturl2pathrErDr]rIrJr�rr�r�r�r�r�r�rBr�r�r��platformZ_scproxyr�r�r�r�r\
rFrr
rcrcrcrd�<module>
s�V
(






L
















?

y&hH*@
Ez

+4:8

AU





^<



-	2