U

��HhRt�@s�dZd
dl
Z
d
dlZd
dlZd
dlZd
dlZd
dlZd
dlZd
dlZd
dl	Z	d
dl
Z
d
dlZddlmZ
ddl
mZ
ddlmZ
ddlmZ
ddlmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"
dd	l#m$Z$
dd
l%m&Z&
ddl'm(Z(m)Z)m*Z*m+Z+
dZ,e�-�Z.d
dd�Z/ej0dk�
r2dd�Z1dd�Zdd�Z2dd�Z3dhdd�
Z4dd�Z5dd�Z6d d!�Z7d"d#�Z8d$d%�Z9d&d'�Z:did(d)�
Z;d*d+�Z<d,d-�Z=d.d/�Z>d0d1�Z?d2d3�Z@d4d5�ZAd6d7�ZBd8d9�ZCeDd:�
ZEd;d<�ZFd=d>�ZGd?d@�ZHdAdB�ZIdCdD�ZJdEdF�ZKejLdGdH��
ZMdIdJ�ZNdjdKdL�
ZOdMdN�ZPdkdPdQ�
ZQdRdS�ZRdTdU�ZSdV�TdW�
ZUeUdXZVeUdYZWdZd[�ZXd\d]�ZYd^d_�ZZe�[d`�
Z\e�[da�
Z]dbdc�Z^ddde�Z_dfdg�Z`dS)lz�
requests.utils
~~~~~~~~~~~~~~

This module provides utility functions that are used within Requests
that are also useful for external consumption.
�N�
�
�__version__)
�certs)
�to_native_string)
�parse_http_list)�quote�urlparse�bytes�str�OrderedDict�unquote�
getproxies�proxy_bypass�
urlunparse�
basestring�
integer_types�is_py3�proxy_bypass_environment�getproxies_environment�Mapping�
�cookiejar_from_dict)
�CaseInsensitiveDict)�
InvalidURL�
InvalidHeader�FileModeWarning�UnrewindableBodyError)z.netrc�_netrc�Pi�
)ZhttpZhttpsZwin32c
Cs�ztrd
dl
}
nd
dl}
Wntk
r0


YdSXz6|
�|
jd�}t|
�|d�d
�
}|
�|d�d
}Wntk
r~


YdSX|r�|s�dS|�	d�
}|D]T}|dkr�d|kr�
d	S|�
dd
�}|�
dd�}|�
d
d�}t�||tj
�r�
d	Sq�dS)Nr
Fz;Software\Microsoft\Windows\CurrentVersion\Internet SettingsZProxyEnableZ
ProxyOverride�
;z<local>�
.Tz\.�
*z.*�
?)r�winreg�_winreg�ImportError�OpenKey�HKEY_CURRENT_USER�intZQueryValueEx�OSError�split�replace�re�match�
I)�hostr$ZinternetSettingsZproxyEnableZ
proxyOverrideZtest�r1�0/usr/lib/python3/dist-packages/requests/utils.py�proxy_bypass_registry/sF







�
�
�
�
�












r3c

Cst�rt
|�
St|�
Sd
S)z�Return True, if the host should be bypassed.

        Checks proxy settings gathered from the environment, if specified,
        or the registry.
        N)rrr3)
r0r1r1r2rVs
rc

Cst|d
�r|�
�}|S)z/Returns an internal sequence dictionary update.�items)�hasattrr4)
�
dr1r1r2�dict_to_sequencebs

r7c
	Cs4
d}
d
}t|d�rt
|�
}
nbt|d�r.|j
}
nPt|d�r~z|��}Wntjk
rZ


Yn$Xt�|�
j}
d|jkr~t	�
dt�
t|d��
rz|��}Wn$t
tfk
r�


|
dk	r�|
}Yn^Xt|d��
r|
dk�
rz&|�d
d	�
|��}
|�|p�d
�

Wnt
tfk
�
r


d
}
YnX|
dk�
r&d
}
td
|
|�S)
Nr
�__len__�len�fileno�
ba%
Requests has determined the content-length for this request using the binary size of the file: however, the file has been opened in text mode (i.e. without the 'b' flag in the mode). This may lead to an incorrect content-length. In Requests 3.0, support will be removed for files in text mode.�tell�seek�)r5r9r:�io�UnsupportedOperation�os�fstat�st_size�mode�warnings�warnrr<r*�IOErrorr=�max)�
oZtotal_lengthZcurrent_positionr:r1r1r2�	super_lenksB














�











rJFc	Cs�z�d
dlm}m
}
d}tD]J}ztj�d�|�
�
}Wntk
rN


Y
WdSXtj�|�
r|}
qfq|dkrtWdSt	|�
}|j
}z:||�
�|�
}	|	r�|	d
r�d
nd}
|	|
|	dfWWSWn|tfk
r�


|
rւYnXWnt
tfk
r�


YnXdS)z;Returns the Requests tuple auth for a given url from netrc.r
)�netrc�NetrcParseErrorNz~/{}rr>)rKrL�NETRC_FILESrA�path�
expanduser�format�KeyError�existsr	�hostnameZauthenticatorsrGr&�AttributeError)�urlZraise_errorsrKrLZ
netrc_path�
fZlocZrir0rZlogin_ir1r1r2�get_netrc_auth�s2













rWc
CsBt|d
d�}
|
r>t
|
t�r>|
ddkr>|
ddkr>tj�|
�
SdS)z0Tries to guess the filename of the given object.�nameNr
�
<����
>)�getattr�
isinstancerrArN�basename)�objrXr1r1r2�guess_filename�s



�r`c
Cs�tj
�|�
r|Stj
�|�
\}
}|
rPtj
�|
�
sPtj
�|
�
\}
}d
�||g�
}q t�|
�
s^|St�|
�
}||��krx|St	�
�}tj
j|f
|�d
�
��}tj
�|�
s�|j||d�}|S)z�Replace nonexistent paths that look like they refer to a member of a zip
    archive with the location of an extracted copy of the target, or else
    just return the provided path unchanged.
    �
/)
rN)rArNrRr+�join�zipfileZ
is_zipfileZZipFileZnamelist�tempfileZ
gettempdir�extract)rN�archive�member�prefixZzip_fileZtmpZextracted_pathr1r1r2�extract_zipped_paths�s 










ric

Cs.|d
krd
St|t
tttf�r&td�
�
t|�
S)a�
Take an object and test to see if it can be represented as a
    dictionary. Unless it can not be represented as such, return an
    OrderedDict, e.g.,

    ::

        >>> from_key_val_list([('key', 'val')])
        OrderedDict([('key', 'val')])
        >>> from_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples
        >>> from_key_val_list({'key': 'val'})
        OrderedDict([('key', 'val')])

    :rtype: OrderedDict
    N�+cannot encode objects that are not 2-tuples)r]rr
�boolr)�
ValueErrorr�
�valuer1r1r2�from_key_val_list�s


roc

Cs@|d
krd
St|t
tttf�r&td�
�
t|t�r8|��}t|�
S)a�
Take an object and test to see if it can be represented as a
    dictionary. If it can be, return a list of tuples, e.g.,

    ::

        >>> to_key_val_list([('key', 'val')])
        [('key', 'val')]
        >>> to_key_val_list({'key': 'val'})
        [('key', 'val')]
        >>> to_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples.

    :rtype: list
    Nrj)	r]rr
rkr)rlrr4�listrmr1r1r2�to_key_val_list
s



rqc
CsXg}
t|�
D]F}|d
d�|dd
�kr4dkrHn
nt
|dd��
}|
�|�

q|
S)aParse 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.  Quotes are removed automatically after parsing.

    It basically works like :func:`parse_set_header` just that items
    may appear multiple times and case sensitivity is preserved.

    The return value is a standard :class:`list`:

    >>> parse_list_header('token, "quoted value"')
    ['token', 'quoted value']

    To create a header from the :class:`list` again, use the
    :func:`dump_header` function.

    :param value: a string with a list header.
    :return: :class:`list`
    :rtype: list
    NrrZ�
")�_parse_list_header�unquote_header_value�append)rn�result�itemr1r1r2�parse_list_header2
s

(


rxc
Csxi}
t|�
D]f}d
|kr"d|
|<q|�
d
d�\}}|dd�|dd�krVdkrjn
nt|dd��
}||
|<q|
S)a^Parse lists of key, value pairs as described by RFC 2068 Section 2 and
    convert them into a python dict:

    >>> d = parse_dict_header('foo="is a fish", bar="as well"')
    >>> type(d) is dict
    True
    >>> sorted(d.items())
    [('bar', 'as well'), ('foo', 'is a fish')]

    If there is no value for a key it will be `None`:

    >>> parse_dict_header('key_without_value')
    {'key_without_value': None}

    To create a header from the :class:`dict` again, use the
    :func:`dump_header` function.

    :param value: a string with a dict header.
    :return: :class:`dict`
    :rtype: dict
    �
=NrrZrr)rsr+rt)rnrvrwrXr1r1r2�parse_dict_headerR
s





(



rzcCs\|rX|d
|dkr dkrXn
n4|dd�}|
rD|dd�dkrX|�dd��d	d�S|S)
z�Unquotes a header value.  (Reversal of :func:`quote_header_value`).
    This does not use the real unquoting but what browsers are actually
    using for quoting.

    :param value: the header value to unquote.
    :rtype: str
    r
rZrrrNr>z\\�
\z\")
r,)rnZis_filenamer1r1r2rtu
s
$

rtc
Csi}
|D]}|j|
|j
<q|
S)
z�Returns a key/value dictionary from a CookieJar.

    :param cj: CookieJar object to extract cookies from.
    :rtype: dict
    )rnrX)�cj�cookie_dictZcookier1r1r2�dict_from_cookiejar�
s
r~cCs
t|
|�S)
z�Returns a CookieJar from a key/value dictionary.

    :param cj: CookieJar to insert cookies into.
    :param cookie_dict: Dict of key/values to insert into CookieJar.
    :rtype: CookieJar
    r)r|r}r1r1r2�add_dict_to_cookiejar�
src
CsTt�
d
t�
tjdtjd�}
tjdtjd�}t�d�
}|
�|�
|�|�
|�|�
S)zlReturns encodings from given content string.

    :param content: bytestring to extract encodings from.
    z�In requests 3.0, get_encodings_from_content will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)z!<meta.*?charset=["\']*(.+?)["\'>])
�flagsz+<meta.*?content=["\']*;?charset=(.+?)["\'>]z$^<\?xml.*?encoding=["\']*(.+?)["\'>])rErF�DeprecationWarningr-�compiler/�findall)�contentZ
charset_reZ	pragma_reZxml_rer1r1r2�get_encodings_from_content�
s
�



��r�c

Cs�|�d
�
}
|
d�
�|
dd�}}i}d}|D]`}|�
�}|r0|d}}|�d�
}	|	dkr�|d|	��
|�
}||	dd��
|�
}|||��<q0||fS)	z�Returns content type and parameters from given header

    :param header: string
    :return: tuple containing content type and dictionary of
         parameters
    r r
rNz"' TryrZ)r+�strip�find�lower)
�header�tokens�content_type�paramsZparams_dictZitems_to_strip�param�keyrnZindex_of_equalsr1r1r2�_parse_content_type_header�
s














r�c
CsD|�d
�
}
|
sdSt
|
�
\}
}d|kr4|d�d�
Sd|
kr@dSdS)z}Returns encodings from given HTTP Header Dict.

    :param headers: dictionary to extract encoding from.
    :rtype: str
    zcontent-typeN�charsetz'"�textz
ISO-8859-1)�getr�r�)�headersr�r�r1r1r2�get_encoding_from_headers�
s



r�ccsj|
jd
kr|D]
}|V
qd
St
�|
j�
dd�
}|D]}|�|�
}|r4|V
q4|jddd�}|rf|V
d
S)zStream decodes a iterator.Nr,�
�errors�T)
�final)�encoding�codecs�getincrementaldecoder�decode)�iterator�
rrw�decoder�chunk�rvr1r1r2�stream_decode_response_unicode�
s











r�ccsHd
}|
dks|
d
k
rt|�
}
|t|�
krD||||
�V
||
7}qdS)z Iterate over slices of a string.r
N)
r9)�stringZslice_length�posr1r1r2�iter_slices�
s




r�c
Cs~t�
d
t�
g}
t|j�
}|rLzt|j|�WStk
rJ


|
�|�

YnXzt|j|dd�WSt	k
rx


|jYSXdS)z�Returns the requested content back in unicode.

    :param r: Response object to get unicode content from.

    Tried:

    1. charset from content-type
    2. fall back and replace all unicode characters

    :rtype: str
    z�In requests 3.0, get_unicode_from_response will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)r,r�N)
rErFr�r�r�rr��UnicodeErrorru�	TypeError)r�Ztried_encodingsr�r1r1r2�get_unicode_from_responses
�







r�zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c
	Cs�|�d
�
}
t
dt|
�
�D]�}|
|dd�}t|�
dkr�|��r�ztt|d��
}Wn tk
rr


td|�
�
YnX|tkr�||
|dd�|
|<q�d
|
||
|<qd
|
||
|<qd�	|
�
S)	z�Un-escape any percent-escape sequences in a URI that are unreserved
    characters. This leaves all reserved, illegal and non-ASCII bytes encoded.

    :rtype: str
    �
%rr
r>�z%Invalid percent-escape sequence: '%s'N�)
r+�ranger9�isalnum�chrr)rlr�UNRESERVED_SETrb)�uri�parts�
i�
h�
cr1r1r2�unquote_unreserved/s









r�c
Cs@d
}
d}ztt
|�
|
d�WStk
r:


t||d�YSXdS)z�Re-quote the given URI.

    This function passes the given URI through an unquote/quote cycle to
    ensure that it is fully and consistently quoted.

    :rtype: str
    z!#$%&'()*+,/:;=?@[]~z!#$&'()*+,/:;=?@[]~)
ZsafeN)rr�r)r�Zsafe_with_percentZsafe_without_percentr1r1r2�requote_uriGs


r�cCslt�
d
t�|�
�d}|
�d�
\}}t�
d
t�tt|�
�
�
�d}t�
d
t�|�
�d|@}||@||@kS)z�This function allows you to check if an IP belongs to a network subnet

    Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
             returns False if ip = 192.168.1.1 and net = 192.168.100.0/24

    :rtype: bool
    z=Lr
ra)�structZunpack�socket�	inet_atonr+�dotted_netmaskr))ZipZnetZipaddrZnetaddr�bitsZnetmaskZnetworkr1r1r2�address_in_network]s




r�c
Cs&d
dd|>dA}
t�
t�d|
��
S)z�Converts mask from /xx format to xxx.xxx.xxx.xxx

    Example: if mask is 24 function returns 255.255.255.0

    :rtype: str
    l��r� z>I)r�Z	inet_ntoar�Zpack)�maskr�r1r1r2r�ls
r�c

Cs,zt�
|�

Wntjk
r&


Yd
SXdS)z
    :rtype: bool
    FT)r�r��error)
Z	string_ipr1r1r2�is_ipv4_addressws




r�c
Cs�|�d
�
dkr�zt
|�d
�
d�
}
Wntk
r:


YdSX|
dksL|
dkrPdSzt�|�d
�
d�

Wq�tjk
r�


YdSXndSdS)zV
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    rarFr�r
T)�countr)r+rlr�r�r�)Zstring_networkr�r1r1r2�
is_valid_cidr�s









r�c	csT|
d
k	}|r"tj
�|�
}|
tj
|<z
d
V
W5|rN|d
krDtj
|=n
|tj
|<Xd
S)z�Set the environment variable 'env_name' to 'value'

    Save previous value, yield, and then restore the previous value stored in
    the environment variable 'env_name'.

    If 'value' is None, do nothingN)rA�environr�)Zenv_namernZ
value_changed�	old_valuer1r1r2�set_environ�s









r�c	
Cs*
d
d�}|
}|
dkr|d�
}
t|�
}|j
dkr2dS|
r�dd�|
�dd	��d
�
D�
}
t|j
�
r�|
D]0}t|�
r�t|j
|�r�
dSq`|j
|kr`
dSq`nB|j
}|jr�|d�|j�
7}|
D] }|j
�	|�
s�|�	|�
r�
dSq�t
d|��6
zt|j
�
}Wn tt
jfk
�
r


d}YnXW5QRX|�
r&dSdS)
zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    c

Sstj
�|�
ptj
�|���
S�
N)rAr�r��upper)
�
kr1r1r2�<lambda>�r�z'should_bypass_proxies.<locals>.<lambda>N�no_proxyTc
ss|]}
|
r|
V
qdSr�r1)�.0r0r1r1r2�	<genexpr>�s
z(should_bypass_proxies.<locals>.<genexpr>�
 r��
,z:{}F)r	rSr,r+r�r�r�ZportrP�endswithr�rr�r�Zgaierror)	rUr�Z	get_proxyZno_proxy_arg�parsedZproxy_ipZhost_with_portr0Zbypassr1r1r2�should_bypass_proxies�s@




�














r�cCst||
d
�riSt
�SdS)zA
    Return a dict of environment proxies.

    :rtype: dict
    )
r�N)r�r)rUr�r1r1r2�get_environ_proxies�s
r�cCst|
pi}
t|�
}|j
d
kr.|
�|j|
�d�
�S|jd|j
|jd|j
dg}d
}|D]}||
krV|
|}
qpqV|S)z�Select a proxy for the url, if applicable.

    :param url: The url being for the request
    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
    N�allz://zall://)r	rSr��scheme)rUZproxiesZurlpartsZ
proxy_keys�proxyZ	proxy_keyr1r1r2�select_proxy�s






�



r��python-requestsc

Csd
|tfS)zO
    Return a string representing the default user agent.

    :rtype: str
    z%s/%sr)
rXr1r1r2�default_user_agentsr�cCstt
�d
�d�
ddd��
S)z9
    :rtype: requests.structures.CaseInsensitiveDict
    z, )ZgzipZdeflatez*/*z
keep-alive)z
User-AgentzAccept-EncodingZAcceptZ
Connection)rr�rbr1r1r1r2�default_headerss



�r�c
	
Cs�g}
d
}|�|�
}|s|
St
�d|�D]�}z|�dd�\}}Wntk
r\


|d}}YnXd|�d�
i
}|�d�
D]F}z|�d�
\}}Wntk
r�


Y
q�YnX|�|�
||�|�
<qv|
�|�

q&|
S)	z�Return a list of parsed link headers proxies.

    i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"

    :rtype: list
    z '"z, *<r rr�rUz<> '"ry)r�r-r+rlru)	rnZlinksZ
replace_chars�valrUr��linkr�r�r1r1r2�parse_header_links(s&










r��
�asciir>�c
Cs�|d
d�}
|
tj
tjfkr dS|
d
d�tjkr6dS|
d
d�tjtjfkrRdS|
�t�
}|dkrhd	S|dkr�|
d
d
d�tkr�d
S|
dd
d�tkr�dS|dkr�|
d
d�t	kr�d
S|
dd
�t	kr�dSd
S)z
    :rtype: str
    N�zutf-32r�z	utf-8-sigr>zutf-16r
zutf-8z	utf-16-berz	utf-16-lez	utf-32-bez	utf-32-le)
r��BOM_UTF32_LE�BOM_UTF32_BE�BOM_UTF8�BOM_UTF16_LE�BOM_UTF16_BEr��_null�_null2�_null3)�dataZsampleZ	nullcountr1r1r2�guess_json_utfSs*


















r�cCs8t||
�\}}}}}}|s$||}}t
||||||f�
S)
z�Given a URL that may or may not have a scheme, prepend the given scheme.
    Does not replace a present scheme with the one provided as an argument.

    :rtype: str
    )r	r)rUZ
new_schemer��netlocrNr��query�fragmentr1r1r2�prepend_scheme_if_neededss

r�c
	CsBt|�
}
zt
|
j�
t
|
j�
f}Wnttfk
r<


d
}YnX|S)z{Given a url with authentication components, extract them into a tuple of
    username,password.

    :rtype: (str,str)
    )r�r�)r	r
ZusernameZpasswordrTr�)rUr�Zauthr1r1r2�get_auth_from_url�s



r�s^\S[^\r\n]*$|^$z^\S[^\r\n]*$|^$c
	Csf|\}
}t|t
�rt}nt}z|�|�
s4td
|
�
�
Wn*tk
r`


td|
|t|�
f�
�
YnXdS)z�Verifies that header value is a string which doesn't contain
    leading whitespace or return characters. This prevents unintended
    header injection.

    :param header: tuple, in the format (name, value).
    z7Invalid return character or leading space in header: %sz>Value for header {%s: %s} must be of type str or bytes, not %sN)r]r
�_CLEAN_HEADER_REGEX_BYTE�_CLEAN_HEADER_REGEX_STRr.rr��type)r�rXrnZpatr1r1r2�check_header_validity�s








�r�c
CsFt|�
\}
}}}}}|s"||}}|�
d
d�d}t|
||||df�
S)zW
    Given a url remove the fragment and the authentication part.

    :rtype: str
    �
@rrZr�)r	�rsplitr)rUr�r�rNr�r�r�r1r1r2�
urldefragauth�s


r�c
	Cs`t|j
d
d�}
|
dk	rTt|jt�rTz|
|j�

Wq\ttfk
rP


td�
�
Yq\Xntd�
�
dS)zfMove file pointer back to its recorded starting position
    so it can be read again on redirect.
    r=Nz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)r\Zbodyr]Z_body_positionrrGr*r)Zprepared_requestZ	body_seekr1r1r2�rewind_body�s




r�)
F)
F)
N)
r�)a�__doc__r��
contextlibr?rAr-r�r��sysrdrErcrr�rZ_internal_utilsr�compatrrsrr	r
rrr
rrrrrrrrrZcookiesrZ
structuresr�
exceptionsrrrrrM�whereZDEFAULT_CA_BUNDLE_PATHZ
DEFAULT_PORTS�platformr3r7rJrWr`rirorqrxrzrtr~rr�r�r�r�r�r��	frozensetr�r�r�r�r�r�r��contextmanagerr�r�r�r�r�r�r��encoder�r�r�r�r�r�r�r�r�r�r�r�r1r1r1r2�<module>s�












D


'	=
-  #

%
�

=

	&