a

?�f�u�@s�dZd
dl
Z
d
dlZd
dlZd
dlZd
dlZd
dlZd
dlZd
dlZd
dl	Z	d
dl
Z
d
dlZd
dlm
Z

ddlmZ
ddlmZ
ddlmZ
ddlmZ
dd	lmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#
dd
l$m%Z%
ddl&m'Z'
ddl(m)Z)m*Z*m+Z+m,Z,
d
Z-e�.�Z/ddd�Z0ej1dk�
r:dd�Z2dd�Zdd�Z3dd�Z4didd�
Z5dd�Z6dd �Z7d!d"�Z8d#d$�Z9d%d&�Z:d'd(�Z;djd)d*�
Z<d+d,�Z=d-d.�Z>d/d0�Z?d1d2�Z@d3d4�ZAd5d6�ZBd7d8�ZCd9d:�ZDeEd;�
ZFd<d=�ZGd>d?�ZHd@dA�ZIdBdC�ZJdDdE�ZKdFdG�ZLejMdHdI��
ZNdJdK�ZOdkdLdM�
ZPdNdO�ZQdldQdR�
ZRdSdT�ZSdUdV�ZTdW�UdX�
ZVeVdYZWeVdZZXd[d\�ZYd]d^�ZZd_d`�Z[e�\da�
Z]e�\db�
Z^dcdd�Z_dedf�Z`dgdh�ZadS)mz�
requests.utils
~~~~~~~~~~~~~~

This module provides utility functions that are used within Requests
that are also useful for external consumption.
�N)
�OrderedDict�
�
�__version__)
�certs)
�to_native_string)
�parse_http_list)�quote�urlparse�bytes�str�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�
)�http�httpsZwin32c
Cs�ztrd
dl
}
nd
dl}
Wnty.


YdS0z6|
�|
jd�}t|
�|d�d
�
}|
�|d�d
}Wntyz


YdS0|r�|s�dS|�	d�
}|D]T}|dkr�d|v
r�
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�winregZ_winreg�ImportError�OpenKey�HKEY_CURRENT_USER�intZQueryValueEx�OSError�split�replace�re�match�
I)�hostr&ZinternetSettingsZproxyEnableZ
proxyOverride�test�r3�>/usr/lib/python3.9/site-packages/pip/_vendor/requests/utils.py�proxy_bypass_registry0sF







�
�
�
�
�












r5c

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)rrr5)
r1r3r3r4rWs
rc

Cst|d
�r|�
�}|S)z/Returns an internal sequence dictionary update.�items)�hasattrr6)
�
dr3r3r4�dict_to_sequencecs

r9c
	Cs.
d}
d
}t|d�rt
|�
}
n`t|d�r.|j
}
nNt|d�r|z|��}WntjyX


Yn$0t�|�
j}
d|jv
r|t	�
dt�
t|d��
rz|��}Wn"t
tfy�


|
du
r�|
}Yn\0t|d��
r|
du�
rz&|�d
d	�
|��}
|�|p�d
�

Wnt
tf�
y


d
}
Yn0|
du�
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�)r7r;r<�io�UnsupportedOperation�os�fstat�st_size�mode�warnings�warnrr>r+�IOErrorr?�max)�
oZtotal_lengthZcurrent_positionr<r3r3r4�	super_lenlsB














�











rLFc	Cs
�z�d
dlm}m
}
d}tD]H}ztj�d�|�
�
}WntyN


Y
WdS0tj�|�
r|}
qfq|durtWdSt	|�
}d}t
|t�r�|�d�
}|j
�|�
d
}	z:||�
�|	�
}
|
r�|
d
r�d
nd}|
||
dfWWSWn|tfy�


|
r��Yn0Wnttf�
y


Yn0dS)	z;Returns the Requests tuple auth for a given url from netrc.r
)�netrc�NetrcParseErrorNz~/{}�
:�asciirr@)rMrN�NETRC_FILESrC�path�
expanduser�format�KeyError�existsr
�
isinstancer�decode�netlocr,ZauthenticatorsrIr'�AttributeError)�urlZraise_errorsrMrNZ
netrc_path�
fZlocZriZsplitstrr1rZlogin_ir3r3r4�get_netrc_auth�s8

















r]c
CsBt|d
d�}
|
r>t
|
t�r>|
ddkr>|
ddkr>tj�|
�
SdS)z0Tries to guess the filename of the given object.�nameNr
�
<����
>)�getattrrWrrCrR�basename)�objr^r3r3r4�guess_filename�s



�rec
Cs�tj
�|�
r|Stj
�|�
\}
}|
rPtj
�|
�
sPtj
�|
�
\}
}d
�||g�
}q t�|
�
s^|St�|
�
}||��v
rx|St	�
�}tj
j|g
|�d
�
�
R�}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.
    �
/)
rR)rCrRrVr,�join�zipfileZ
is_zipfileZZipFileZnamelist�tempfileZ
gettempdir�extract)rR�archive�member�prefixZzip_file�tmpZextracted_pathr3r3r4�extract_zipped_paths�s 










roc

Cs.|d
urd
St|t
tttf�r&td�
�
t|�
S)aTake 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')
        Traceback (most recent call last):
        ...
        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)rWrr�boolr*�
ValueErrorr�
�valuer3r3r4�from_key_val_list
s


ruc

Cs@|d
ur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')
        Traceback (most recent call last):
        ...
        ValueError: cannot encode objects that are not 2-tuples

    :rtype: list
    Nrp)	rWrrrqr*rrrr6�listrsr3r3r4�to_key_val_list
s



rwc
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
    Nrr`�
")�_parse_list_header�unquote_header_value�append)rt�result�itemr3r3r4�parse_list_header=
s

(


r~c
Csxi}
t|�
D]f}d
|v
r"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
    �
=Nrr`rx)ryr,rz)rtr|r}r^r3r3r4�parse_dict_header]
s





(



r�cCs\|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
r`rxrNr@z\\�
\z\")
r-)rtZis_filenamer3r3r4rz�
s
$

rzc
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
    )rtr^)�cj�cookie_dictZcookier3r3r4�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�r3r3r4�add_dict_to_cookiejar�
sr�c
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=["\']*(.+?)["\'>])rGrH�DeprecationWarningr.�compiler0�findall)�contentZ
charset_reZ	pragma_reZxml_rer3r3r4�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"' Trr`)r,�strip�find�lower)
�header�tokens�content_type�paramsZparams_dictZitems_to_strip�param�keyrtZindex_of_equalsr3r3r4�_parse_content_type_header�
s














r�c
CsD|�d
�
}
|
sdSt
|
�
\}
}d|vr4|d�d�
Sd|
vr@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�r3r3r4�get_encoding_from_headers�
s



r�ccsj|
jd
ur|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�getincrementaldecoderrX)�iterator�
rr}�decoder�chunk�rvr3r3r4�stream_decode_response_unicode�
s











r�ccsHd
}|
dus|
d
k
rt|�
}
|t|�
krD||||
�V
||
7}qdS)z Iterate over slices of a string.r
N)
r;)�stringZslice_length�posr3r3r4�iter_slicess




r�c
Cszt�
d
t�
g}
t|j�
}|rJzt|j|�WStyH


|
�|�

Yn0zt|j|dd�WSt	yt


|jYS0dS)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)
rGrHr�r�r�rr��UnicodeErrorr{�	TypeError)r�Ztried_encodingsr�r3r3r4�get_unicode_from_responses
�






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


td|�
�
Yn0|tvr�||
|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,�ranger;�isalnum�chrr*rrr�UNRESERVED_SETrg)�uri�parts�
i�
h�
cr3r3r4�unquote_unreserved:s









r�c
Cs>d
}
d}ztt
|�
|
d�WSty8


t||d�YS0dS)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!#$&'()*+,/:;=?@[]~)
�safeN)r	r�r)r�Zsafe_with_percentZsafe_without_percentr3r3r4�requote_uriRs


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
rf)�struct�unpack�socket�	inet_atonr,�dotted_netmaskr*)ZipZnetZipaddrZnetaddr�bitsZnetmaskZnetworkr3r3r4�address_in_networkhs




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��pack)�maskr�r3r3r4r�ws
r�c

Cs*zt�
|�

Wntjy$


Yd
S0dS)z
    :rtype: bool
    FT)r�r��error)
Z	string_ipr3r3r4�is_ipv4_address�s




r�c
Cs�|�d
�
dkr�zt
|�d
�
d�
}
Wnty8


YdS0|
dksJ|
dkrNdSzt�|�d
�
d�

Wq�tjy|


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

    :rtype: bool
    rfrFr�r
T)�countr*r,rrr�r�r�)Zstring_networkr�r3r3r4�
is_valid_cidr�s









r�c	cst|
d
u
}|r"tj
�|�
}|
tj
|<z*d
V
W|rp|d
urBtj
|=qp|tj
|<n"|rn|d
urdtj
|=n
|tj
|<0d
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)rC�environr�)Zenv_namertZ
value_changed�	old_valuer3r3r4�set_environ�s








�


r�c	
Cs>
d
d�}|
}|
dur|d�
}
t|�
}|j
dur2dS|
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|��>
zt|j
�
}Wntt
jf�
y


d}Yn0Wd�
n1�
s&0


Y
|�
r:dSdS)
zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    c

Sstj
�|�
ptj
�|���
S�
N)rCr�r��upper)
�
kr3r3r4�<lambda>�r�z'should_bypass_proxies.<locals>.<lambda>N�no_proxyTc
ss|]}
|
r|
V
qdSr�r3)�.0r1r3r3r4�	<genexpr>�s
z(should_bypass_proxies.<locals>.<genexpr>�
 r��
,z:{}F)r
�hostnamer-r,r�r�r��portrT�endswithr�rr�r�Zgaierror)	r[r�Z	get_proxyZno_proxy_arg�parsedZproxy_ipZhost_with_portr1Zbypassr3r3r4�should_bypass_proxies�s@




�













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

    :rtype: dict
    )
r�N)r�r)r[r�r3r3r4�get_environ_proxies�s
r�cCst|
pi}
t|�
}|j
d
ur.|
�|j|
�d�
�S|jd|j
|jd|j
dg}d
}|D]}||
vrV|
|}
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
r�r��scheme)r[ZproxiesZurlpartsZ
proxy_keys�proxyZ	proxy_keyr3r3r4�select_proxys






�



r��python-requestsc

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

    :rtype: str
    z%s/%sr)
r^r3r3r4�default_user_agentsr�cCstt
�d
�d�
ddd��
S)z9
    :rtype: requests.structures.CaseInsensitiveDict
    z, )ZgzipZdeflatez*/*z
keep-alive)z
User-AgentzAccept-EncodingZAcceptZ
Connection)rr�rgr3r3r3r4�default_headers's



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


|d}}Yn0d|�d�
i
}|�d�
D]D}z|�d�
\}}Wnty�


Y
q�Yn0|�|�
||�|�
<qt|
�|�

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�r[z<> '"r)r�r.r,rrr{)	rtZlinksZ
replace_chars�valr[r��linkr�r�r3r3r4�parse_header_links3s&










r��
rPr@�c
Cs�|d
d�}
|
tj
tjfvr dS|
d
d�tjkr6dS|
d
d�tjtjfvrRdS|
�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	nullcountr3r3r4�guess_json_utf^s*


















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)r[Z
new_schemer�rYrRr��query�fragmentr3r3r4�prepend_scheme_if_needed~s

r�c
	Cs@t|�
}
zt
|
j�
t
|
j�
f}Wnttfy:


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

    :rtype: (str,str)
    )r�r�)r
r
�username�passwordrZr�)r[r�Zauthr3r3r4�get_auth_from_url�s



r�s^\S[^\r\n]*$|^$z^\S[^\r\n]*$|^$c
	Csd|\}
}t|t
�rt}nt}z|�|�
s4td
|
�
�
Wn(ty^


td|
|t|�
f�
�
Yn0dS)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)rWr�_CLEAN_HEADER_REGEX_BYTE�_CLEAN_HEADER_REGEX_STRr/rr��type)r�r^rt�patr3r3r4�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
    �
@rr`r�)r
�rsplitr)r[r�rYrRr�r�r�r3r3r4�
urldefragauth�s


r

c
	Cs^t|j
d
d�}
|
du
rRt|jt�rRz|
|j�

WqZttfyN


td�
�
YqZ0ntd�
�
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.)rb�bodyrWZ_body_positionrrIr+r)Zprepared_requestZ	body_seekr3r3r4�rewind_body�s




r
)
F)
F)
N)
r�)b�__doc__r��
contextlibrArCr.r�r��sysrirGrh�collectionsrrr�rZ_internal_utilsr�compatrryr	r
rrr
rrrrrrrrrZcookiesrZ
structuresr�
exceptionsrrrrrQ�whereZDEFAULT_CA_BUNDLE_PATHZ
DEFAULT_PORTS�platformr5r9rLr]rerorurwr~r�rzr�r�r�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
r3r3r3r4�<module>s�













@


'	=
3  #

%
�

=

	&