a
    ÷£Be¨‚  ã                   @   sò  d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlmZ ddlmZmZ ddlmZ ddlmZ ddlmZmZmZmZ dd	lmZmZmZmZmZmZ dd
lm Z! ddlm"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z( ddl)m*Z* ddl+m,Z,m-Z-m.Z.m/Z/ ddl0m1Z1 dZ2e 3¡ Z4dddœZ5d 6e 7dedd�d ¡¡Z8ej9dk�rvdd„ Z:dd„ Z"dd„ Z;dd „ Z<dtd"d#„Z=d$d%„ Z>d&d'„ Z?ej@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„ ZVej@dQdR„ ƒZWdSdT„ ZXdvdUdV„ZYdWdX„ ZZdwdYdZ„Z[dxd\d]„Z\d^d_„ Z]d`da„ Z^db _dc¡Z`e`dd Zae`de Zbdfdg„ Zcdhdi„ Zddjdk„ Zedldm„ Zfdndo„ Zgdpdq„ Zhdrds„ ZidS )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éP   i»  )ÚhttpÚhttpsz, z,\s*T)Úaccept_encodingzaccept-encodingÚwin32c              	   C   sæ   zdd l }W n ty    Y dS 0 z6| |jd¡}t| |d¡d ƒ}| |d¡d }W n ttfyp   Y dS 0 |rz|s~dS | d¡}|D ]T}|dkr¦d| vr¦ d	S | 	dd
¡}| 	dd¡}| 	dd¡}t
 || t
j¡rŒ d	S qŒdS )Nr   Fz;Software\Microsoft\Windows\CurrentVersion\Internet SettingsZProxyEnableZProxyOverrideú;z<local>Ú.Tz\.Ú*z.*ú?)ÚwinregÚImportErrorÚOpenKeyÚHKEY_CURRENT_USERÚintÚQueryValueExÚOSErrorÚ
ValueErrorÚsplitÚreplaceÚreÚmatchÚI)Úhostr,   ZinternetSettingsZproxyEnableZproxyOverrideÚtest© r;   úQ/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/requests/utils.pyÚproxy_bypass_registryL   s4    þ
r=   c                 C   s   t ƒ rt| ƒS t| ƒS dS )zšReturn True, if the host should be bypassed.

        Checks proxy settings gathered from the environment, if specified,
        or the registry.
        N)r   r   r=   )r9   r;   r;   r<   r   p   s    r   c                 C   s   t | dƒr|  ¡ } | S )z/Returns an internal sequence dictionary update.Úitems)Úhasattrr>   )Údr;   r;   r<   Údict_to_sequence|   s    
rA   c              	   C   s*  d }d}t | dƒrt| ƒ}ndt | dƒr.| j}nRt | dƒr€z|  ¡ }W n tjtfy\   Y n$0 t |¡j}d| j	vr€t
 dt¡ t | dƒ�rz|  ¡ }W n ty¶   |d ur²|}Y nX0 t | dƒ�r|d u �rz&|  dd	¡ |  ¡ }|  |pîd¡ W n t�y   d}Y n0 |d u �rd}td|| ƒ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?   rC   rD   ÚioÚUnsupportedOperationÚAttributeErrorÚosÚfstatÚst_sizeÚmodeÚwarningsÚwarnr   rF   r2   rG   Úmax)ÚoÚtotal_lengthÚcurrent_positionrD   r;   r;   r<   Ú	super_len…   sB    




÷


rV   Fc              	   C   sF  t j d¡}|dur|f}ndd„ tD ƒ}� züddlm}m} d}|D ]B}zt j |¡}W n tyr   Y  W dS 0 t j 	|¡rF|} qŠqF|du r˜W dS t
| ƒ}	d}
t| tƒr¸|
 d¡}
|	j |
¡d }z<||ƒ |¡}|�r|d rêdnd	}|| |d
 fW W S W n  |tf�y$   |�r ‚ Y n0 W n ttf�y@   Y n0 dS )z;Returns the Requests tuple auth for a given url from netrc.ÚNETRCNc                 s   s   | ]}d |› �V  qdS )z~/Nr;   )Ú.0Úfr;   r;   r<   Ú	<genexpr>Î   ó    z!get_netrc_auth.<locals>.<genexpr>r   )ÚNetrcParseErrorÚnetrcó   :Úasciir   rH   )rL   ÚenvironÚgetÚNETRC_FILESr]   r\   ÚpathÚ
expanduserÚKeyErrorÚexistsr   Ú
isinstancer   ÚdecodeÚnetlocr4   Úauthenticatorsr2   r-   rK   )ÚurlÚraise_errorsÚ
netrc_fileÚnetrc_locationsr\   r]   Ú
netrc_pathrY   ÚlocÚriÚsplitstrr9   r"   Úlogin_ir;   r;   r<   Úget_netrc_authÇ   s@    

rt   c                 C   sB   t | ddƒ}|r>t|tƒr>|d dkr>|d dkr>tj |¡S dS )z0Tries to guess the filename of the given object.ÚnameNr   ú<éÿÿÿÿú>)Úgetattrrg   r   rL   rc   Úbasename)Úobjru   r;   r;   r<   Úguess_filename   s    &r|   c                 C   sæ   t j | ¡r| S t j | ¡\}}|rVt j |¡sVt j |¡\}}|sFqVd ||g¡}q t |¡sd| S t |¡}|| ¡ vr~| S t	 
¡ }t j || d¡d ¡}t j |¡sât|ƒ� }| | |¡¡ W d  ƒ n1 sØ0    Y  |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.
    ú/rw   N)rL   rc   rf   r4   ÚjoinÚzipfileÚ
is_zipfileÚZipFileÚnamelistÚtempfileÚ
gettempdirÚatomic_openÚwriteÚread)rc   ÚarchiveÚmemberÚprefixÚzip_fileÚtmpÚextracted_pathÚfile_handlerr;   r;   r<   Úextract_zipped_paths  s&    


.r�   c                 c   s~   t jtj | ¡d�\}}zBt |d¡�}|V  W d  ƒ n1 sB0    Y  t || ¡ W n tyx   t |¡ ‚ Y n0 dS )z-Write a file to the disk in an atomic fashion)ÚdirÚwbN)	rƒ   ÚmkstemprL   rc   ÚdirnameÚfdopenr5   ÚBaseExceptionÚremove)ÚfilenameÚtmp_descriptorÚtmp_nameÚtmp_handlerr;   r;   r<   r…   ,  s    $
r…   c                 C   s.   | du rdS t | ttttfƒr&tdƒ‚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')
        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)rg   r   r   Úboolr0   r3   r   ©Úvaluer;   r;   r<   Úfrom_key_val_list9  s
    rŸ   c                 C   s@   | du rdS t | ttttfƒr&tdƒ‚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›   )	rg   r   r   rœ   r0   r3   r   r>   Úlistr�   r;   r;   r<   Úto_key_val_listT  s    
r¡   c                 C   sX   g }t | ƒD ]F}|dd… |dd…   kr4dkrHn nt|dd… ƒ}| |¡ q|S )a  Parse 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
    Nr   rw   ú")Ú_parse_list_headerÚunquote_header_valueÚappend)rž   ÚresultÚitemr;   r;   r<   Úparse_list_headerr  s    (r¨   c                 C   sx   i }t | ƒD ]f}d|vr"d||< q| dd¡\}} | dd… | dd…   krVdkrjn nt| dd… ƒ} | ||< 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
    ú=Nr   rw   r¢   )r£   r4   r¤   )rž   r¦   r§   ru   r;   r;   r<   Úparse_dict_header’  s    (
rª   c                 C   s\   | rX| d | d   kr dkrXn n4| dd… } |rD| dd… dkrX|   dd¡  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   rw   r¢   r   NrH   z\\ú\z\")r5   )rž   Úis_filenamer;   r;   r<   r¤   µ  s
    $r¤   c                 C   s   i }| 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ž   ru   )ÚcjÚcookie_dictÚcookier;   r;   r<   Údict_from_cookiejarÎ  s    r°   c                 C   s
   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Ý  s    r±   c                 C   sT   t  dt¡ tjdtjd�}tjdtjd�}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=["\']*(.+?)["\'>])rP   rQ   ÚDeprecationWarningr6   Úcompiler8   Úfindall)ÚcontentÚ
charset_reÚ	pragma_reÚxml_rer;   r;   r<   Úget_encodings_from_contentè  s    ú	
ÿþÿrº   c           
      C   sš   |   d¡}|d  ¡ |dd…  }}i }d}|D ]`}| ¡ }|r0|d }}| d¡}	|	dkr„|d|	…  |¡}||	d d…  |¡}||| ¡ < q0||fS )	z¦Returns content type and parameters from given header

    :param header: string
    :return: tuple containing content type and dictionary of
         parameters
    r(   r   r   Nz"' Tr©   rw   )r4   ÚstripÚfindÚlower)
ÚheaderÚtokensÚcontent_typeÚparamsÚparams_dictÚitems_to_stripÚparamÚkeyrž   Úindex_of_equalsr;   r;   r<   Ú_parse_content_type_header  s    


rÇ   c                 C   sP   |   d¡}|sdS t|ƒ\}}d|v r4|d  d¡S d|v r@dS d|v rLdS dS )	z}Returns encodings from given HTTP Header Dict.

    :param headers: dictionary to extract encoding from.
    :rtype: str
    zcontent-typeNÚcharsetz'"Útextz
ISO-8859-1zapplication/jsonúutf-8)ra   rÇ   r»   )ÚheadersrÀ   rÁ   r;   r;   r<   Úget_encoding_from_headers  s    
rÌ   c                 c   sd   |j du r| E dH  dS t |j ¡dd�}| D ]}| |¡}|r.|V  q.|jddd�}|r`|V  dS )zStream decodes an iterator.Nr5   ©Úerrorsr[   T)Úfinal)ÚencodingÚcodecsÚgetincrementaldecoderrh   )ÚiteratorÚrÚdecoderÚchunkÚrvr;   r;   r<   Ústream_decode_response_unicode3  s    


rØ   c                 c   sH   d}|du s|dkrt | ƒ}|t | ƒk rD| ||| … V  ||7 }qdS )z Iterate over slices of a string.r   N)rC   )ÚstringÚslice_lengthÚposr;   r;   r<   Úiter_slicesD  s    rÜ   c                 C   sz   t  dt¡ g }t| jƒ}|rJzt| j|ƒW S  tyH   | |¡ Y n0 zt| j|dd�W S  t	yt   | j Y S 0 dS )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.)r5   rÍ   N)
rP   rQ   r³   rÌ   rË   r   r¶   ÚUnicodeErrorr¥   Ú	TypeError)rÔ   Útried_encodingsrÐ   r;   r;   r<   Úget_unicode_from_responseN  s    ú	
rà   zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c              	   C   sÊ   |   d¡}tdt|ƒƒD ]¦}|| dd… }t|ƒdkr¬| ¡ r¬ztt|dƒƒ}W n" tyt   td|› d�ƒ‚Y n0 |tv r˜||| dd…  ||< q¾d|| › �||< qd|| › �||< qd	 	|¡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
    ú%r   r   rH   é   z"Invalid percent-escape sequence: 'ú'NÚ )
r4   ÚrangerC   ÚisalnumÚchrr0   r3   r   ÚUNRESERVED_SETr~   )ÚuriÚpartsÚiÚhÚcr;   r;   r<   Úunquote_unreserved{  s    
rî   c                 C   s>   d}d}zt t| ƒ|d�W S  ty8   t | |d� Y S 0 dS )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é   Úsafe_with_percentÚsafe_without_percentr;   r;   r<   Úrequote_uri“  s    rò   c                 C   sl   t  dt | ¡¡d }| d¡\}}t  dt tt|ƒƒ¡¡d }t  dt |¡¡d |@ }||@ ||@ kS )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   r}   )ÚstructÚunpackÚsocketÚ	inet_atonr4   Údotted_netmaskr0   )ÚipÚnetÚipaddrÚnetaddrÚbitsÚnetmaskÚnetworkr;   r;   r<   Úaddress_in_network©  s
    rÿ   c                 C   s&   ddd|  > d A }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÷   ¸  s    r÷   c                 C   s(   zt  | ¡ W n ty"   Y dS 0 dS )z
    :rtype: bool
    FT)rõ   rö   r2   )Ú	string_ipr;   r;   r<   Úis_ipv4_addressÃ  s
    r  c                 C   s†   |   d¡dkr~zt|  d¡d ƒ}W n ty8   Y dS 0 |dk sJ|dkrNdS zt |  d¡d ¡ W q‚ tyz   Y dS 0 ndS dS )zV
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    r}   r   Fr   r   T)Úcountr0   r4   r3   rõ   rö   r2   )Ústring_networkr  r;   r;   r<   Úis_valid_cidrÎ  s    
r  c              	   c   st   |du}|r"t j | ¡}|t j| < z*dV  W |rp|du rBt j| = qp|t j| < n"|rn|du rdt j| = n
|t j| < 0 d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)rL   r`   ra   )Úenv_namerž   Úvalue_changedÚ	old_valuer;   r;   r<   Úset_environæ  s    

ü
r  c           	   
   C   s>  dd„ }|}|du r|dƒ}t | ƒ}|jdu r2dS |rÖdd„ | dd	¡ d
¡D ƒ}t|jƒr”|D ]0}t|ƒr€t|j|ƒr� dS q`|j|kr` dS q`nB|j}|jr°|d|j› �7 }|D ] }|j |¡sÎ| |¡r´ dS q´t	d|ƒ�> zt
|jƒ}W n ttjf�y   d}Y n0 W d  ƒ n1 �s&0    Y  |�r:dS dS )zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    c                 S   s   t j | ¡pt j |  ¡ ¡S ©N)rL   r`   ra   Úupper)rÅ   r;   r;   r<   Ú	get_proxy  s    z(should_bypass_proxies.<locals>.get_proxyNÚno_proxyTc                 s   s   | ]}|r|V  qd S r  r;   )rX   r9   r;   r;   r<   rZ     r[   z(should_bypass_proxies.<locals>.<genexpr>ú rä   ú,ú:F)r   Úhostnamer5   r4   r  r  rÿ   ÚportÚendswithr  r   rÞ   rõ   Úgaierror)	rk   r  r  Úno_proxy_argÚparsedÚproxy_ipÚhost_with_portr9   Úbypassr;   r;   r<   Úshould_bypass_proxiesü  s<    



*r  c                 C   s   t | |d�ri S tƒ S dS )zA
    Return a dict of environment proxies.

    :rtype: dict
    ©r  N)r  r   )rk   r  r;   r;   r<   Úget_environ_proxies8  s    r  c                 C   st   |pi }t | ƒ}|jdu r.| |j| d¡¡S |jd |j |jd|j dg}d}|D ]}||v rV|| } 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://zall://)r   r  ra   Úscheme)rk   ÚproxiesÚurlpartsÚ
proxy_keysÚproxyÚ	proxy_keyr;   r;   r<   Úselect_proxyD  s    
ür'  c           	      C   st   |dur|ni }| 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  r  r   )rk   r   r!  ra   Úcopyr  r  Ú
setdefault)	Úrequestr"  Ú	trust_envrk   r!  r  Únew_proxiesÚenviron_proxiesr%  r;   r;   r<   Úresolve_proxies^  s    

r.  úpython-requestsc                 C   s   | › dt › �S )zO
    Return a string representing the default user agent.

    :rtype: str
    r}   r   )ru   r;   r;   r<   Údefault_user_agenty  s    r0  c                   C   s   t tƒ tdddœƒS )z9
    :rtype: requests.structures.CaseInsensitiveDict
    z*/*z
keep-alive)z
User-AgentzAccept-EncodingÚAcceptÚ
Connection)r!   r0  ÚDEFAULT_ACCEPT_ENCODINGr;   r;   r;   r<   Údefault_headers‚  s    üÿr4  c           	   
   C   sÊ   g }d}|   |¡} | s|S t d| ¡D ]ž}z| dd¡\}}W n tyZ   |d }}Y n0 d|  d¡i}| d¡D ]D}z| d¡\}} W n ty¢   Y  qºY n0 |   |¡||  |¡< 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(   r   rä   rk   z<> '"r©   )r»   r6   r4   r3   r¥   )	rž   ÚlinksÚreplace_charsÚvalrk   rÁ   ÚlinkrÄ   rÅ   r;   r;   r<   Úparse_header_links�  s&    
r9  ú r_   rH   é   c                 C   sÐ   | dd… }|t jt jfv r dS |dd… t jkr6dS |dd… t jt jfv rRdS | t¡}|dkrhd	S |dkrœ|ddd… tkr†d
S |ddd… tkrœdS |dkrÌ|dd… t	kr¸dS |dd… t	krÌdS dS )z
    :rtype: str
    Né   zutf-32r;  z	utf-8-sigrH   zutf-16r   rÊ   z	utf-16-ber   z	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*    
rH  c                 C   sl   t | ƒ}|\}}}}}}}	|j}
|
s.||
 }
}|r@d ||
g¡}
|du rL|}|du rXd}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ä   )r   ri   r~   r   )rk   Ú
new_schemer  r!  Úauthr9   r  rc   ÚqueryÚfragmentri   r;   r;   r<   Úprepend_scheme_if_neededÛ  s    
rN  c              	   C   s@   t | ƒ}zt|jƒt|jƒf}W n ttfy:   d}Y n0 |S )z{Given a url with authentication components, extract them into a tuple of
    username,password.

    :rtype: (str,str)
    )rä   rä   )r   r   ÚusernameÚpasswordrK   rÞ   )rk   r  rK  r;   r;   r<   Úget_auth_from_urlø  s    
rQ  c                 C   s$   | \}}t | |dƒ t | |dƒ dS )z§Verifies that header parts don't contain leading whitespace
    reserved characters, or return characters.

    :param header: tuple, in the format (name, value).
    r   r   N)Ú_validate_header_part)r¾   ru   rž   r;   r;   r<   Úcheck_header_validity  s    rS  c                 C   sx   t |tƒrt| }n2t |tƒr(t| }ntd|›d| › dt|ƒ› �ƒ‚| |¡st|dkr\dnd}td|› d|›�ƒ‚d S )	NzHeader part (z) from z# must be of type str or bytes, not r   ru   rž   zSInvalid leading whitespace, reserved character(s), or returncharacter(s) in header z: )rg   r   r
   r   r	   r   Útyper7   )r¾   Úheader_partÚheader_validator_indexÚ	validatorÚheader_kindr;   r;   r<   rR    s$    



ÿÿ
ÿÿÿrR  c                 C   sF   t | ƒ\}}}}}}|s"|| }}| dd¡d }t|||||dfƒS )zW
    Given a url remove the fragment and the authentication part.

    :rtype: str
    rI  r   rw   rä   )r   Úrsplitr   )rk   r!  ri   rc   rÁ   rL  rM  r;   r;   r<   Úurldefragauth&  s
    
rZ  c                 C   sZ   t | jddƒ}|durNt| jtƒrNz|| jƒ W qV tyJ   tdƒ‚Y qV0 ntdƒ‚dS )zfMove file pointer back to its recorded starting position
    so it can be read again on redirect.
    rG   Nz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)ry   Úbodyrg   Ú_body_positionr   r2   r    )Úprepared_requestÚ	body_seekr;   r;   r<   Úrewind_body7  s    
ÿÿr_  )F)F)N)T)r/  )jÚ__doc__rÑ   Ú
contextlibrI   rL   r6   rõ   ró   Úsysrƒ   rP   r   Úcollectionsr   Zurllib3.utilr   r   rä   r   r   Ú_internal_utilsr	   r
   r   r   Úcompatr   r   r   r   r   r   r   r£   r   r   r   r   r   r   r   Úcookiesr   Ú
exceptionsr   r   r   r    Ú
structuresr!   rb   ÚwhereÚDEFAULT_CA_BUNDLE_PATHÚDEFAULT_PORTSr~   r4   r3  Úplatformr=   rA   rV   rt   r|   r�   Úcontextmanagerr…   rŸ   r¡   r¨   rª   r¤   r°   r±   rº   rÇ   rÌ   rØ   rÜ   rà   Ú	frozensetrè   rî   rò   rÿ   r÷   r  r  r  r  r  r'  r.  r0  r4  r9  ÚencoderB  rC  rD  rH  rN  rQ  rS  rR  rZ  r_  r;   r;   r;   r<   Ú<module>   sž    $	
ÿ$	B
9%
 #

(ÿ
<


	&
 