HEX

File: //opt/python38/lib/python3.8/site-packages/pip/_vendor/requests/__pycache__/utils.cpython-38.pyc
U

��e���@s�dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
ddlmZmZddlmZddlmZddlmZmZmZmZdd	lmZmZmZmZmZmZdd
lm Z!ddlm"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(ddl)m*Z*dd
l+m,Z,m-Z-m.Z.m/Z/ddl0m1Z1dZ2e�3�Z4ddd�Z5d�6e�7dedd�d��Z8ej9dk�rvdd�Z:dd�Z"dd�Z;dd �Z<dtd"d#�Z=d$d%�Z>d&d'�Z?ej@d(d)��ZAd*d+�ZBd,d-�ZCd.d/�ZDd0d1�ZEdud2d3�ZFd4d5�ZGd6d7�ZHd8d9�ZId:d;�ZJd<d=�ZKd>d?�ZLd@dA�ZMdBdC�ZNeOdD�ZPdEdF�ZQdGdH�ZRdIdJ�ZSdKdL�ZTdMdN�ZUdOdP�ZVej@dQdR��ZWdSdT�ZXdvdUdV�ZYdWdX�ZZdwdYdZ�Z[dxd\d]�Z\d^d_�Z]d`da�Z^db�_dc�Z`e`ddZae`deZbdfdg�Zcdhdi�Zddjdk�Zedldm�Zfdndo�Zgdpdq�Zhdrds�ZidS)yz�
requests.utils
~~~~~~~~~~~~~~

This module provides utility functions that are used within Requests
that are also useful for external consumption.
�N)�OrderedDict)�make_headers�	parse_url�)�certs��__version__)�_HEADER_VALIDATORS_BYTE�_HEADER_VALIDATORS_STR�HEADER_VALIDATORS�to_native_string)�Mapping�
basestring�bytes�
getproxies�getproxies_environment�
integer_types)�parse_http_list)�proxy_bypass�proxy_bypass_environment�quote�str�unquote�urlparse�
urlunparse��cookiejar_from_dict)�FileModeWarning�
InvalidHeader�
InvalidURL�UnrewindableBodyError)�CaseInsensitiveDict)z.netrc�_netrc�Pi�)�http�httpsz, z,\s*T)�accept_encodingzaccept-encoding�win32c	Cs�zddl}Wntk
r"YdSXz6|�|jd�}t|�|d�d�}|�|d�d}Wnttfk
rtYdSX|r~|s�dS|�d�}|D]T}|dkr�d|kr�d	S|�	dd
�}|�	dd�}|�	d
d�}t
�||t
j�r�d	Sq�dS)NrFz;Software\Microsoft\Windows\CurrentVersion\Internet SettingsZProxyEnableZ
ProxyOverride�;z<local>�.Tz\.�*z.*�?)
�winreg�ImportError�OpenKey�HKEY_CURRENT_USER�int�QueryValueEx�OSError�
ValueError�split�replace�re�match�I)�hostr,ZinternetSettingsZproxyEnableZ
proxyOverride�test�r;�>/tmp/pip-unpacked-wheel-uzdrexel/pip/_vendor/requests/utils.py�proxy_bypass_registryLs4�
r=cCst�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)rrr=)r9r;r;r<rpsrcCst|d�r|��}|S)z/Returns an internal sequence dictionary update.�items)�hasattrr>)�dr;r;r<�dict_to_sequence|s
rAc	Cs0d}d}t|d�rt|�}nft|d�r.|j}nTt|d�r�z|��}Wntjtfk
r^Yn$Xt�|�j}d|j	kr�t
�dt�t|d��rz|�
�}Wn tk
r�|dk	r�|}YnZXt|d��r|dk�rz&|�dd	�|�
�}|�|p�d�Wntk
�rd}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�)r?rCrD�io�UnsupportedOperation�AttributeError�os�fstat�st_size�mode�warnings�warnrrFr2rG�max)�o�total_length�current_positionrDr;r;r<�	super_len�sB




�


rVFc	CsLtj�d�}|dk	r|f}ndd�tD�}�zddlm}m}d}|D]D}ztj�|�}Wntk
rtYWdSXtj�	|�rF|}q�qF|dkr�WdSt
|�}	d}
t|t�r�|
�
d�}
|	j�|
�d}z<||��|�}|�r|dr�dnd	}
||
|d
fWWSWn"|tfk
�r(|�r$�YnXWnttfk
�rFYnXdS)z;Returns the Requests tuple auth for a given url from netrc.ZNETRCNcss|]}d|��VqdS)z~/Nr;)�.0�fr;r;r<�	<genexpr>�sz!get_netrc_auth.<locals>.<genexpr>r)�NetrcParseError�netrc�:�asciirrH)rL�environ�get�NETRC_FILESr[rZ�path�
expanduser�KeyError�existsr�
isinstancer�decode�netlocr4�authenticatorsr2r-rK)�url�raise_errorsZ
netrc_fileZnetrc_locationsrZr[�
netrc_pathrX�loc�ri�splitstrr9r"�login_ir;r;r<�get_netrc_auth�s@

rpcCsBt|dd�}|r>t|t�r>|ddkr>|ddkr>tj�|�SdS)z0Tries to guess the filename of the given object.�nameNr�<����>)�getattrrerrLra�basename)�objrqr;r;r<�guess_filenames&rxc	Cs�tj�|�r|Stj�|�\}}|rVtj�|�sVtj�|�\}}|sFqVd�||g�}q t�|�sd|St�|�}||��kr~|St	�
�}tj�||�d�d�}tj�|�s�t|��}|�|�
|��W5QRX|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.
    �/rs)rLrardr4�join�zipfile�
is_zipfile�ZipFile�namelist�tempfile�
gettempdir�atomic_open�write�read)ra�archive�member�prefix�zip_file�tmp�extracted_pathZfile_handlerr;r;r<�extract_zipped_pathss&


r�c	csltjtj�|�d�\}}z.t�|d��}|VW5QRXt�||�Wn tk
rft�|��YnXdS)z-Write a file to the disk in an atomic fashion)�dir�wbN)	r�mkstemprLra�dirname�fdopenr5�
BaseException�remove)�filenameZtmp_descriptorZtmp_nameZtmp_handlerr;r;r<r�,s
r�cCs.|dkrdSt|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)rerr�boolr0r3r��valuer;r;r<�from_key_val_list9s
r�cCs@|dkrdSt|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�)	rerrr�r0r3r
r>�listr�r;r;r<�to_key_val_listTs
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
    Nrrs�")�_parse_list_header�unquote_header_value�append)r��result�itemr;r;r<�parse_list_headerrs(r�cCsxi}t|�D]f}d|kr"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
    �=Nrrsr�)r�r4r�)r�r�r�rqr;r;r<�parse_dict_header�s(
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
    rrsr�rNrHz\\�\z\")r5)r��is_filenamer;r;r<r��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�rq)�cj�cookie_dict�cookier;r;r<�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�r;r;r<�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=["\']*(.+?)["\'>])rPrQ�DeprecationWarningr6�compiler8�findall)�content�
charset_re�	pragma_re�xml_rer;r;r<�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�rs)r4�strip�find�lower)
�header�tokens�content_type�params�params_dict�items_to_strip�param�keyr��index_of_equalsr;r;r<�_parse_content_type_headers


r�cCsP|�d�}|sdSt|�\}}d|kr4|d�d�Sd|kr@dSd|krLdSdS)	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)r_r�r�)�headersr�r�r;r;r<�get_encoding_from_headerss
r�ccsd|jdkr|EdHdSt�|j�dd�}|D]}|�|�}|r.|Vq.|jddd�}|r`|VdS)zStream decodes an iterator.Nr5��errors�T)�final)�encoding�codecs�getincrementaldecoderrf)�iterator�r�decoder�chunk�rvr;r;r<�stream_decode_response_unicode3s


r�ccsHd}|dks|dkrt|�}|t|�krD||||�V||7}qdS)z Iterate over slices of a string.rN)rC)�string�slice_length�posr;r;r<�iter_slicesDsr�cCs~t�dt�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.)r5r�N)
rPrQr�r�r�rr��UnicodeErrorr��	TypeError)r��tried_encodingsr�r;r;r<�get_unicode_from_responseNs�	
r�zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c	Cs�|�d�}tdt|��D]�}||dd�}t|�dkr�|��r�ztt|d��}Wn$tk
rvtd|�d���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
    �%rrrH�z"Invalid percent-escape sequence: '�'N�)
r4�rangerC�isalnum�chrr0r3r�UNRESERVED_SETrz)�uri�parts�i�h�cr;r;r<�unquote_unreserved{s
r�cCs@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!#$&'()*+,/:;=?@[]~)�safeN)rr�r)r��safe_with_percent�safe_without_percentr;r;r<�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=Lrry)�struct�unpack�socket�	inet_atonr4�dotted_netmaskr0)�ip�net�ipaddr�netaddr�bits�netmask�networkr;r;r<�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��r� z>I)r��	inet_ntoar��pack)�maskr�r;r;r<r��sr�cCs*zt�|�Wntk
r$YdSXdS)z
    :rtype: bool
    FT)r�r�r2)�	string_ipr;r;r<�is_ipv4_address�s
r�cCs�|�d�dkr�zt|�d�d�}Wntk
r:YdSX|dksL|dkrPdSzt�|�d�d�Wq�tk
r~YdSXndSdS)zV
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    ryrFr�rT)�countr0r4r3r�r�r2)�string_networkr�r;r;r<�
is_valid_cidr�s
rc	csT|dk	}|r"tj�|�}|tj|<z
dVW5|rN|dkrDtj|=n
|tj|<XdS)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)rLr^r_)�env_namer��
value_changed�	old_valuer;r;r<�set_environ�s


rc	
Cs*dd�}|}|dkr|d�}t|�}|jdkr2dS|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|��6zt
|j�}Wn ttj
fk
�rd}YnXW5QRX|�r&dSdS)
zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    cSstj�|�ptj�|���S�N)rLr^r_�upper)r�r;r;r<�	get_proxysz(should_bypass_proxies.<locals>.get_proxyN�no_proxyTcss|]}|r|VqdSrr;)rWr9r;r;r<rYsz(should_bypass_proxies.<locals>.<genexpr>� r��,�:F)r�hostnamer5r4r�rr��port�endswithrrr�r��gaierror)	rir	r�no_proxy_arg�parsed�proxy_ip�host_with_portr9�bypassr;r;r<�should_bypass_proxies�s<



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

    :rtype: dict
    �r	N)rr)rir	r;r;r<�get_environ_proxies8srcCst|pi}t|�}|jdkr.|�|j|�d��S|jd|j|jd|jdg}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://)rr
r_�scheme)ri�proxies�urlparts�
proxy_keys�proxy�	proxy_keyr;r;r<�select_proxyDs
�r c	Cst|dk	r|ni}|j}t|�j}|�d�}|��}|rpt||d�spt||d�}|�||�d��}|rp|�||�|S)a�This method takes proxy information from a request and configuration
    input to resolve a mapping of target proxies. This will consider settings
    such a NO_PROXY to strip proxy configurations.

    :param request: Request or PreparedRequest
    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
    :param trust_env: Boolean declaring whether to trust environment configs

    :rtype: dict
    Nr	rr)rirrr_�copyrr�
setdefault)	�requestr�	trust_envrirr	�new_proxies�environ_proxiesrr;r;r<�resolve_proxies^s

r'�python-requestscCs|�dt��S)zO
    Return a string representing the default user agent.

    :rtype: str
    ryr)rqr;r;r<�default_user_agentysr)cCstt�tddd��S)z9
    :rtype: requests.structures.CaseInsensitiveDict
    z*/*z
keep-alive)z
User-AgentzAccept-Encoding�Accept�
Connection)r!r)�DEFAULT_ACCEPT_ENCODINGr;r;r;r<�default_headers�s��r-c	
Cs�g}d}|�|�}|s|St�d|�D]�}z|�dd�\}}Wntk
r\|d}}YnXd|�d�i}|�d�D]F}z|�d�\}}Wntk
r�Yq�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�riz<> '"r�)r�r6r4r3r�)	r��links�
replace_chars�valrir��linkr�r�r;r;r<�parse_header_links�s&
r2�r]rH�cCs�|dd�}|tjtjfkr dS|dd�tjkr6dS|dd�tjtjfkrRdS|�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-32r4z	utf-8-sigrHzutf-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�sample�	nullcountr;r;r<�guess_json_utf�s*
rAcCslt|�}|\}}}}}}}	|j}
|
s.||
}
}|r@d�||
g�}
|dkrL|}|dkrXd}t||
|d||	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
    �@Nr�)rrgrzr)ri�
new_schemerr�authr9rra�query�fragmentrgr;r;r<�prepend_scheme_if_needed�s
rGc	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�)rr�username�passwordrKr�)rirrDr;r;r<�get_auth_from_url�s
rJcCs$|\}}t||d�t||d�dS)z�Verifies that header parts don't contain leading whitespace
    reserved characters, or return characters.

    :param header: tuple, in the format (name, value).
    rrN)�_validate_header_part)r�rqr�r;r;r<�check_header_validitysrLcCsxt|t�rt|}n2t|t�r(t|}ntd|�d|�dt|�����|�|�st|dkr\dnd}td|�d|����dS)	Nz
Header part (z) from z# must be of type str or bytes, not rrqr�zSInvalid leading whitespace, reserved character(s), or returncharacter(s) in header z: )rerr
rr	r�typer7)r�Zheader_partZheader_validator_indexZ	validatorZheader_kindr;r;r<rKs



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

    :rtype: str
    rBrrsr�)r�rsplitr)rirrgrar�rErFr;r;r<�
urldefragauth&s

rOcCs\t|jdd�}|dk	rPt|jt�rPz||j�WqXtk
rLtd��YqXXntd��dS)zfMove file pointer back to its recorded starting position
    so it can be read again on redirect.
    rGNz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)ru�bodyre�_body_positionrr2r )�prepared_request�	body_seekr;r;r<�rewind_body7s
��rT)F)F)N)T)r()j�__doc__r��
contextlibrIrLr6r�r��sysrrPr{�collectionsr�pip._vendor.urllib3.utilrrr�rr�_internal_utilsr	r
rr�compatr
rrrrrrr�rrrrrrr�cookiesr�
exceptionsrrrr �
structuresr!r`�where�DEFAULT_CA_BUNDLE_PATH�
DEFAULT_PORTSrzr4r,�platformr=rArVrprxr��contextmanagerr�r�r�r�r�r�r�r�r�r�r�r�r�r��	frozensetr�r�r�r�r�r�rrrrr r'r)r-r2�encoder;r<r=rArGrJrLrKrOrTr;r;r;r<�<module>s� $	
�$	B
9%
 #

(�
<


	&