????

Your IP : 3.144.37.229

Current Path : /lib/python3.9/site-packages/requests/__pycache__/
Upload File :
Current File : //lib/python3.9/site-packages/requests/__pycache__/utils.cpython-39.opt-1.pyc

a

/'f�}�@s�dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
ddlmZddlmZddlmZddlmZdd	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�Z4dpdd�Z5dd�Z6dd �Z7d!d"�Z8d#d$�Z9d%d&�Z:d'd(�Z;dqd)d*�Z<d+d,�Z=d-d.�Z>d/d0�Z?d1d2�Z@d3d4�ZAd5d6�ZBd7d8�ZCd9d:�ZDeEd;�ZFd<d=�ZGd>d?�ZHdrdAdB�ZIdCdD�ZJdEdF�ZKdGdH�ZLdIdJ�ZMdKdL�ZNdMdN�ZOejPdOdP��ZQdQdR�ZRdsdSdT�ZSdUdV�ZTdtdXdY�ZUdZd[�ZVd\d]�ZWd^�Xd_�ZYeYd`ZZeYdaZ[dbdc�Z\ddde�Z]dfdg�Z^e�_dh�Z`e�_di�Zadjdk�Zbdldm�Zcdndo�ZddS)uz�
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�https�win32cCs�ztrddl}nddl}Wnty.YdS0z6|�|jd�}t|�|d�d�}|�|d�d}WntyzYdS0|r�|s�dS|�	d�}|D]T}|dkr�d|vr�d	S|�
dd
�}|�
dd�}|�
d
d�}t�||tj
�r�d	Sq�dS)NrFz;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�r4�2/usr/lib/python3.9/site-packages/requests/utils.py�proxy_bypass_registry0sF
�����
r6cCst�rt|�St|�SdS)z�Return True, if the host should be bypassed.

        Checks proxy settings gathered from the environment, if specified,
        or the registry.
        N)rrr6)r2r4r4r5rWsrcCst|d�r|��}|S)z/Returns an internal sequence dictionary update.�items)�hasattrr7)�dr4r4r5�dict_to_sequencecs
r:c	Cs.d}d}t|d�rt|�}n`t|d�r.|j}nNt|d�r|z|��}WntjyXYn$0t�|�j}d|jvr|t	�
dt�t|d��rz|��}Wn"t
tfy�|dur�|}Yn\0t|d��r|du�rz&|�dd	�|��}|�|p�d�Wnt
tf�yd}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�)r8r<r=�io�UnsupportedOperation�os�fstat�st_size�mode�warnings�warnrr?r,�IOErrorr@�max)�oZtotal_lengthZcurrent_positionr=r4r4r5�	super_lenlsB




�



rMFc	CsFtj�d�}|dur|f}ndd�tD�}�z�ddlm}m}d}|D]B}ztj�|�}WntyrYWdS0tj�	|�rF|}q�qF|dur�WdSt
|�}	d}
t|t�r�|
�
d�}
|	j�|
�d}z<||��|�}|�r|dr�dnd	}
||
|d
fWWSWn |tf�y$|�r �Yn0Wnttf�y@Yn0dS)z;Returns the Requests tuple auth for a given url from netrc.ZNETRCNcss|]}d�|�VqdS)z~/{}N)�format)�.0�fr4r4r5�	<genexpr>��z!get_netrc_auth.<locals>.<genexpr>r)�netrc�NetrcParseError�:�asciirrA)rD�environ�get�NETRC_FILESrSrT�path�
expanduser�KeyError�existsr
�
isinstancer�decode�netlocr-ZauthenticatorsrJr(�AttributeError)�urlZraise_errorsZ
netrc_fileZnetrc_locationsrSrTZ
netrc_pathrP�locZriZsplitstrr2rZlogin_ir4r4r5�get_netrc_auth�s@

rdcCsBt|dd�}|r>t|t�r>|ddkr>|ddkr>tj�|�SdS)z0Tries to guess the filename of the given object.�nameNr�<����>)�getattrr^rrDrZ�basename)�objrer4r4r5�guess_filename�s

�rlcCs�tj�|�r|Stj�|�\}}|rPtj�|�sPtj�|�\}}d�||g�}q t�|�s^|St�|�}||��vrx|St	�
�}tjj|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.
    �/)rZ)rDrZr]r-�join�zipfile�
is_zipfile�ZipFileZnamelist�tempfileZ
gettempdir�extract)rZ�archive�member�prefixZzip_file�tmpZextracted_pathr4r4r5�extract_zipped_paths�s 

rxcCs.|durdSt|ttttf�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)r^rr�boolr+�
ValueErrorr��valuer4r4r5�from_key_val_list
s
r~cCs@|durdSt|ttttf�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
    Nry)	r^rrrzr+r{rr7�listr|r4r4r5�to_key_val_list%s
r�cCsXg}t|�D]F}|dd�|dd�kr4dkrHnnt|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
    Nrrg�")�_parse_list_header�unquote_header_value�append)r}�result�itemr4r4r5�parse_list_headerCs(r�cCsxi}t|�D]f}d|vr"d||<q|�dd�\}}|dd�|dd�krVdkrjnnt|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
    �=Nrrgr�)r�r-r�)r}r�r�rer4r4r5�parse_dict_headercs(
r�cCs\|rX|d|dkr dkrXnn4|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
    rrgr�rNrAz\\�\z\")r.)r}Zis_filenamer4r4r5r��s
$r�cCsi}|D]}|j||j<q|S)z�Returns a key/value dictionary from a CookieJar.

    :param cj: CookieJar object to extract cookies from.
    :rtype: dict
    )r}re)�cj�cookie_dictZcookier4r4r5�dict_from_cookiejar�sr�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�r4r4r5�add_dict_to_cookiejar�sr�cCsTt�dt�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=["\']*(.+?)["\'>])rHrI�DeprecationWarningr/�compiler1�findall)�contentZ
charset_reZ	pragma_reZxml_rer4r4r5�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#rrNz"' Tr�rg)r-�strip�find�lower)
�header�tokens�content_type�paramsZparams_dictZitems_to_strip�param�keyr}Zindex_of_equalsr4r4r5�_parse_content_type_header�s


r�cCsP|�d�}|sdSt|�\}}d|vr4|d�d�Sd|vr@dSd|vrLdSdS)	z}Returns encodings from given HTTP Header Dict.

    :param headers: dictionary to extract encoding from.
    :rtype: str
    zcontent-typeN�charsetz'"�textz
ISO-8859-1zapplication/json�utf-8)rXr�r�)�headersr�r�r4r4r5�get_encoding_from_headers�s
r�ccsj|jdur|D]
}|VqdSt�|j�dd�}|D]}|�|�}|r4|Vq4|jddd�}|rf|VdS)zStream decodes a iterator.Nr.��errorsrRT)�final)�encoding�codecs�getincrementaldecoderr_)�iterator�rr��decoder�chunk�rvr4r4r5�stream_decode_response_unicode�s

r�ccsHd}|dus|dkrt|�}|t|�krD||||�V||7}qdS)z Iterate over slices of a string.rN)r<)�stringZslice_length�posr4r4r5�iter_slicessr�cCszt�dt�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)
rHrIr�r�r�rr��UnicodeErrorr��	TypeError)r�Ztried_encodingsr�r4r4r5�get_unicode_from_responses�
r�zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c	Cs�|�d�}tdt|��D]�}||dd�}t|�dkr�|��r�ztt|d��}Wntyptd|��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
    �%rrrA�z%Invalid percent-escape sequence: '%s'N�)
r-�ranger<�isalnum�chrr+r{r�UNRESERVED_SETrn)�uri�parts�i�h�cr4r4r5�unquote_unreservedDs
r�cCs>d}d}ztt|�|d�WSty8t||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_percentr4r4r5�requote_uri\sr�� cCsd|>d||>}|S)aConverts a mask from /xx format to a int
    to be used as a mask for IP's in int format

    Example: if mask is 24 function returns 0xFFFFFF00
             if mask is 24 and totalbits=128 function
                returns 0xFFFFFF00000000000000000000000000

    :rtype: int
    rr4)�maskZ	totalbits�bitsr4r4r5�_get_mask_bitsrs
r�cCs�|�d�\}}t|�rXt|�rXt�dt�|��d}tt|��}t�dt�|��d}npt|�r�t|�r�t�dt�	tj
|��\}}|d>|A}tt|�d�}t�dt�	tj
|��\}	}
|	d>|
A}ndS||@||@kS)a3This 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
             returns True if ip = 1:2:3:4::1 and net = 1:2:3:4::/64

    :rtype: bool
    rmz>Lrz>QQ�@�F)r-�is_ipv4_address�struct�unpack�socketZ	inet_atonr�r+�is_ipv6_address�	inet_pton�AF_INET6)ZipZnetZnetaddrr�ZipaddrZnetmaskZnetworkZ
ipaddr_msbZ
ipaddr_lsbZnetwork_msbZnetwork_lsbr4r4r5�address_in_network�s"	��r�cCs&ddd|>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��rr�z>I)r�Z	inet_ntoar��pack)r�r�r4r4r5�dotted_netmask�sr�cCs.zt�tj|�Wntjy(YdS0dS�z
    :rtype: bool
    FT)r�r�ZAF_INET�error�Z	string_ipr4r4r5r��s
r�cCs.zt�tj|�Wntjy(YdS0dSr�)r�r�r�r�r�r4r4r5r��s
r�cCsD||krdSzt�tj|�t�tj|�kWSty>YdS0dS)zW
    Compare 2 IP's, uses socket.inet_pton to normalize IPv6 IPs

    :rtype: bool
    TFN)r�r�r�r,)�ar>r4r4r5�compare_ips�s�r�cCs�|�d�dkr�|�d�\}}zt|�}Wnty<YdS0t|�r\|dksV|dkr~dSq�t|�rz|dkst|dkr~dSq�dSndSdS)zV
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    rmrFr�r�T)�countr-r+r{r�r�)Zstring_networkZaddressr�r4r4r5�
is_valid_cidr�sr�c	cst|du}|r"tj�|�}|tj|<z*dVW|rp|durBtj|=qp|tj|<n"|rn|durdtj|=n
|tj|<0dS)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)rDrWrX)Zenv_namer}Z
value_changed�	old_valuer4r4r5�set_environ�s

�
r�c	
CsJdd�}|}|dur|d�}t|�}|jdur2dS|r�dd�|�dd	��d
�D�}t|j�sft|j�r�|D]2}t|�r�t|j|�r�dSqjt|j|�rjdSqjnB|j}|j	r�|d�
|j	�7}|D] }|j�|�s�|�|�r�dSq�td|��>zt
|j�}Wnttjf�yd}Yn0Wd�n1�s20Y|�rFdSdS)
zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    cSstj�|�ptj�|���S�N)rDrWrX�upper)�kr4r4r5�<lambda>rRz'should_bypass_proxies.<locals>.<lambda>N�no_proxyTcss|]}|r|VqdSr�r4)rOr2r4r4r5rQsz(should_bypass_proxies.<locals>.<genexpr>� r��,z:{}F)r
�hostnamer.r-r�r�r�r�r��portrN�endswithr�rr�r�Zgaierror)	rbr�Z	get_proxyZno_proxy_arg�parsedZproxy_ipZhost_with_portr2Zbypassr4r4r5�should_bypass_proxies�s@
�
*r�cCst||d�riSt�SdS)zA
    Return a dict of environment proxies.

    :rtype: dict
    )r�N)r�r)rbr�r4r4r5�get_environ_proxies;sr�cCst|pi}t|�}|jdur.|�|j|�d��S|jd|j|jd|jdg}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�rX�scheme)rbZproxiesZurlpartsZ
proxy_keys�proxyZ	proxy_keyr4r4r5�select_proxyGs
�r��python-requestscCsd|tfS)zO
    Return a string representing the default user agent.

    :rtype: str
    z%s/%sr)rer4r4r5�default_user_agentasr�cCstt�d�d�ddd��S)z9
    :rtype: requests.structures.CaseInsensitiveDict
    z, )�gzipZdeflatez*/*z
keep-alive)z
User-AgentzAccept-EncodingZAcceptZ
Connection)rr�rnr4r4r4r5�default_headersjs�r�c	
Cs�g}d}|�|�}|s|St�d|�D]�}z|�dd�\}}WntyZ|d}}Yn0d|�d�i}|�d�D]D}z|�d�\}}Wnty�Yq�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�rbz<> '"r�)r�r/r-r{r�)	r}ZlinksZ
replace_chars�valrbr��linkr�r�r4r4r5�parse_header_linksvs&
r��rVrA�cCs�|dd�}|tjtjfvr dS|dd�tjkr6dS|dd�tjtjfvrRdS|�t�}|dkrhd	S|dkr�|ddd�tkr�d
S|ddd�tkr�dS|dkr�|dd�t	kr�d
S|dd�t	kr�dSdS)z
    :rtype: str
    N�zutf-32r�z	utf-8-sigrAzutf-16rr�z	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	nullcountr4r4r5�guess_json_utf�s*
rcCs8t||�\}}}}}}|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)rbZ
new_schemer�r`rZr��query�fragmentr4r4r5�prepend_scheme_if_needed�s
rc	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�passwordrar�)rbr�Zauthr4r4r5�get_auth_from_url�s
rs^\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)r^r�_CLEAN_HEADER_REGEX_BYTE�_CLEAN_HEADER_REGEX_STRr0rr��type)r�rer}�patr4r4r5�check_header_validity�s

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

    :rtype: str
    �@rrgr�)r
�rsplitr)rbr�r`rZr�rrr4r4r5�
urldefragauth�s

rc	Cs^t|jdd�}|durRt|jt�rRz||j�WqZttfyNtd��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.)ri�bodyr^Z_body_positionrrJr,r)Zprepared_requestZ	body_seekr4r4r5�rewind_body
sr)F)F)r�)N)r�)e�__doc__r��
contextlibrBrDr/r�r��sysrrrHro�collectionsrrr�rZ_internal_utilsr�compatrr�r	r
rrr
rrrrrrrrrZcookiesrZ
structuresr�
exceptionsrrrrrY�whereZDEFAULT_CA_BUNDLE_PATHZ
DEFAULT_PORTS�platformr6r:rMrdrlrxr~r�r�r�r�r�r�r�r�r�r�r�r��	frozensetr�r�r�r�r�r�r�r�r�r��contextmanagerr�r�r�r�r�r�r��encoder�r�rrrrr�r	r
r
rrr4r4r4r5�<module>s�@
'	=
9  #

%�

=

	&