HEX

File: //usr/lib/python3/dist-packages/requests/__pycache__/utils.cpython-39.pyc
a

Ba�_Aw�@s�dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
ddlmZddlmZddlmZddlmZdd	lmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#dd
l$m%Z%ddl&m'Z'ddl(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�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�winreg�_winreg�ImportError�OpenKey�HKEY_CURRENT_USER�int�QueryValueEx�OSError�split�replace�re�match�I)�hostr'ZinternetSettingsZproxyEnableZ
proxyOverride�test�r6�0/usr/lib/python3/dist-packages/requests/utils.py�proxy_bypass_registry0sF
�����
r8cCst�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)rrr8)r4r6r6r7rWsrcCst|d�r|��}|S)z/Returns an internal sequence dictionary update.�items)�hasattrr9)�dr6r6r7�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�)r:r>r?�io�UnsupportedOperation�os�fstat�st_size�mode�warnings�warnrrAr.�IOErrorrB�max)�oZtotal_lengthZcurrent_positionr?r6r6r7�	super_lenlsB




�



rOFc	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�fr6r6r7�	<genexpr>��z!get_netrc_auth.<locals>.<genexpr>r)�netrc�NetrcParseError�:�asciirrC)rF�environ�get�NETRC_FILESrUrV�path�
expanduser�KeyError�existsr
�
isinstancer�decode�netlocr/ZauthenticatorsrLr)�AttributeError)�urlZraise_errorsZ
netrc_fileZnetrc_locationsrUrVZ
netrc_pathrR�locZriZsplitstrr4rZlogin_ir6r6r7�get_netrc_auth�s@

rfcCsBt|dd�}|r>t|t�r>|ddkr>|ddkr>tj�|�SdS)z0Tries to guess the filename of the given object.�nameNr�<����>)�getattrr`rrFr\�basename)�objrgr6r6r7�guess_filename�s

�rncCs�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.
    �/)r\)rFr\r_r/�join�zipfile�
is_zipfile�ZipFile�namelist�tempfile�
gettempdir�extract)r\�archive�member�prefixZzip_file�tmpZextracted_pathr6r6r7�extract_zipped_paths�s 

r|cCs.|durdSt|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`rr�boolr,�
ValueErrorr��valuer6r6r7�from_key_val_list
s
r�cCs@|durdSt|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
    Nr})	r`rrr~r,rrr9�listr�r6r6r7�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
    Nrri�")�_parse_list_header�unquote_header_value�append)r��result�itemr6r6r7�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
    �=Nrrir�)r�r/r�)r�r�r�rgr6r6r7�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
    rrir�rNrCz\\�\z\")r0)r�Zis_filenamer6r6r7r��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�rg)�cj�cookie_dictZcookier6r6r7�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�r6r6r7�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=["\']*(.+?)["\'>])rJrK�DeprecationWarningr1�compiler3�findall)�contentZ
charset_reZ	pragma_reZxml_rer6r6r7�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�ri)r/�strip�find�lower)
�header�tokens�content_type�paramsZparams_dictZitems_to_strip�param�keyr�Zindex_of_equalsr6r6r7�_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
    zcontent-typeN�charsetz'"�textz
ISO-8859-1zapplication/json�utf-8)rZr�r�)�headersr�r�r6r6r7�get_encoding_from_headers�s
r�ccsj|jdur|D]
}|VqdSt�|j�dd�}|D]}|�|�}|r4|Vq4|jddd�}|rf|VdS)zStream decodes a iterator.Nr0��errorsrTT)�final)�encoding�codecs�getincrementaldecoderra)�iterator�rr��decoder�chunk�rvr6r6r7�stream_decode_response_unicode�s

r�ccsHd}|dus|dkrt|�}|t|�krD||||�V||7}qdS)z Iterate over slices of a string.rN)r>)�stringZslice_length�posr6r6r7�iter_slicessr�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.)r0r�N)
rJrKr�r�r�rr��UnicodeErrorr��	TypeError)r�Ztried_encodingsr�r6r6r7�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
    �%rrrC�z%Invalid percent-escape sequence: '%s'N�)
r/�ranger>�isalnum�chrr,rr�UNRESERVED_SETrp)�uri�parts�i�h�cr6r6r7�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_percentr6r6r7�requote_uri\sr�cCslt�dt�|��d}|�d�\}}t�dt�tt|����d}t�dt�|��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=Lrro)�struct�unpack�socket�	inet_atonr/�dotted_netmaskr,)�ip�netZipaddrZnetaddr�bits�netmask�networkr6r6r7�address_in_networkrs
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��r� z>I)r��	inet_ntoar��pack)�maskr�r6r6r7r��sr�cCs*zt�|�Wntjy$YdS0dS)z
    :rtype: bool
    FT)r�r��error)Z	string_ipr6r6r7�is_ipv4_address�s
r�cCs�|�d�dkr�zt|�d�d�}Wnty8YdS0|dksJ|dkrNdSzt�|�d�d�Wq�tjy|YdS0ndSdS)zV
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    rorFr�rT)�countr,r/rr�r�r�)Zstring_networkr�r6r6r7�
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)rFrYrZ)Zenv_namer�Z
value_changed�	old_valuer6r6r7�set_environ�s

�
r�c	
Cs>dd�}|}|dur|d�}t|�}|jdur2dS|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�}Wntt
jf�yd}Yn0Wd�n1�s&0Y|�r:dSdS)
zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    cSstj�|�ptj�|���S�N)rFrYrZ�upper)�kr6r6r7�<lambda>�rTz'should_bypass_proxies.<locals>.<lambda>N�no_proxyTcss|]}|r|VqdSr�r6)rQr4r6r6r7rS�sz(should_bypass_proxies.<locals>.<genexpr>� r��,z:{}F)r
�hostnamer0r/r�r�r��portrP�endswithr�rr�r��gaierror)	rdr�Z	get_proxyZno_proxy_arg�parsedZproxy_ipZhost_with_portr4Zbypassr6r6r7�should_bypass_proxies�s@
�


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

    :rtype: dict
    )r�N)r�r)rdr�r6r6r7�get_environ_proxiessr�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�rZ�scheme)rdZproxiesZurlpartsZ
proxy_keys�proxyZ	proxy_keyr6r6r7�select_proxys
�r��python-requestscCsd|tfS)zO
    Return a string representing the default user agent.

    :rtype: str
    z%s/%sr)rgr6r6r7�default_user_agent(sr�cCstt�d�d�ddd��S)z9
    :rtype: requests.structures.CaseInsensitiveDict
    z, )�gzip�deflatez*/*z
keep-alive)z
User-AgentzAccept-Encoding�Accept�
Connection)rr�rpr6r6r6r7�default_headers1s�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�rdz<> '"r�)r�r1r/rr�)	r�ZlinksZ
replace_chars�valrdr��linkr�r�r6r6r7�parse_header_links=s&
r��rXrC�cCs�|dd�}|tjtjfvr dS|dd�tjkr6dS|dd�tjtjfvrRdS|�t�}|dkrhd	S|dkr�|ddd�tkr�d
S|ddd�tkr�dS|dkr�|dd�t	kr�d
S|dd�t	kr�dSdS)z
    :rtype: str
    N�zutf-32r�z	utf-8-sigrCzutf-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)�data�sampleZ	nullcountr6r6r7�guess_json_utfhs*
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)rdZ
new_schemer�rbr\r��query�fragmentr6r6r7�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�passwordrcr�)rdr��authr6r6r7�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_STRr2rr��type)r�rgr��patr6r6r7�check_header_validity�s

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

    :rtype: str
    �@rrir�)r
�rsplitr)rdr�rbr\r�rr	r6r6r7�
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.
    rBNz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)rk�bodyr`Z_body_positionrrLr.r)Zprepared_request�	body_seekr6r6r7�rewind_body�sr)F)F)N)r�)b�__doc__r��
contextlibrDrFr1r�r��sysrurJrq�collectionsrrr�rZ_internal_utilsr�compatrr�r	r
rrr
rrrrrrrrrZcookiesrZ
structuresr�
exceptionsrrrrr[�whereZDEFAULT_CA_BUNDLE_PATHZ
DEFAULT_PORTS�platformr8r<rOrfrnr|r�r�r�r�r�r�r�r�r�r�r�r�r��	frozensetr�r�r�r�r�r�r��contextmanagerr�r�r�r�r�r�r��encoderrrrr
rr�rrrrrr6r6r6r7�<module>s�@
'	=
9  #

%�
=

	&