U
|
I=®dàu ã @ sª d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
|
Z
|
ddl Z ddl m Z ddlmZ ddlmZ ddlmZ ddlmZ dd lmZmZmZmZmZmZm Z m Z m Z m Z m Z m!Z!m"Z"m#Z# dd
|
l$m%Z% dd l&m'Z' dd l(m)Z)m*Z*m+Z+m,Z, d Z-e .¡ Z/dddZ0ej1dkr:dd Z2dd Z dd Z3dd Z4didd Z5d d Z6d d 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 ZOdkdLdMZPdNdO ZQdldQdRZRdSdT ZSdUdV ZTdW UdX¡ZVeVdY ZWeVdZ ZXd[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éP i» )ÚhttpÚhttpsÚwin32c C sô zt rdd l}ndd l}W n tk
|
r0 Y dS X z6| |jd¡}t| |d¡d }| |d¡d }W n tk
|
r~ Y dS X |r|sdS | d¡}|D ]T}|dkr´d| kr´ d S |
|
dd
|
¡}|
|
d d ¡}|
|
d d¡}t || t j ¡r d S qdS )Nr Fz;Software\Microsoft\Windows\CurrentVersion\Internet SettingsÚ ProxyEnableÚ ProxyOverrideú;z<local>Ú.Tz\.Ú*z.*ú?)r ÚwinregÚ_winregÚ ImportErrorÚOpenKeyÚHKEY_CURRENT_USERÚintÚ QueryValueExÚOSErrorÚsplitÚreplaceÚreÚmatchÚI)Úhostr) ÚinternetSettingsÚ proxyEnableÚ proxyOverrideÚtest© r; úQD:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\pip/_vendor/requests/utils.pyÚproxy_bypass_registry0 sF
|
ÿÿÿÿÿ
|
r= c C s t rt| S t| S dS )zReturn True, if the host should be bypassed.
|
|
Checks proxy settings gathered from the environment, if specified,
|
or the registry.
|
N)r r r= )r6 r; r; r< r W s r c C s t | dr| ¡ } | S )z/Returns an internal sequence dictionary update.Úitems)Úhasattrr> )Údr; r; r< Údict_to_sequencec s
|
rA c C s4 d }d}t | dr t| }nbt | dr.| j}nPt | dr~z | ¡ }W n tjk
|
rZ Y n$X t |¡j}d| jkr~t
|
dt ¡ t | drz | ¡ }W n$ t tfk
|
rº |d k r¶|}Y n^X t | dr|d krz&| dd ¡ | ¡ }| |pòd¡ W n t tfk
|
r d}Y nX |d kr&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? rC rD ÚioÚUnsupportedOperationÚosÚfstatÚst_sizeÚmodeÚwarningsÚwarnr rF r0 ÚIOErrorrG Úmax)ÚoÚ total_lengthÚcurrent_positionrD r; r; r< Ú super_lenl sB
|
|
|
|
|
ù
|
|
|
|
rV Fc C s& zddl m }m} d}tD ]J}ztj d |¡¡}W n tk
|
rP Y W dS X tj |¡r |} qhq |dkrvW dS t | }d}t
|
| t r| d¡}|j |¡d } z:|| | ¡}
|
|
|
rÞ|
|
d rÆdnd} |
|
| |
|
d fW W S W n" |tfk
|
r | rþ Y nX W n ttfk
|
r Y nX dS ) z;Returns the Requests tuple auth for a given url from netrc.r )ÚnetrcÚNetrcParseErrorNz~/{}ó :Úasciir rH )rW rX Ú NETRC_FILESrK ÚpathÚ
|
expanduserÚformatÚKeyErrorÚexistsr
|
Ú
|
isinstancer ÚdecodeÚnetlocr1 ÚauthenticatorsrQ r+ ÚAttributeError) ÚurlÚ raise_errorsrW rX Ú
|
netrc_pathÚfÚlocÚriÚsplitstrr6 r Úlogin_ir; r; r< Úget_netrc_auth© s8
|
|
rn c C sB t | dd}|r>t|tr>|d dkr>|d dkr>tj |¡S dS )z0Tries to guess the filename of the given object.ÚnameNr ú<éÿÿÿÿú>)Úgetattrra r rK r\ Úbasename)Úobjro r; r; r< Úguess_filenameÜ s
|
|
ÿrv c C s¶ t j | ¡r| S t j | ¡\}}|rPt j |¡sPt j |¡\}}d ||g¡}q t |¡s^| S t |¡}|| ¡ krx| S t
|
¡ }t jj|f| d¡ }t j |¡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\ ) rK r\ r` r1 ÚjoinÚzipfileÚ
|
is_zipfileÚZipFileÚnamelistÚtempfileÚ
|
gettempdirÚextract)r\ ÚarchiveÚmemberÚprefixÚzip_fileÚtmpÚextracted_pathr; r; r< Úextract_zipped_pathsä s
|
|
r c C s. | dkr dS t | ttttfr&tdt| 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)ra r r Úboolr. Ú
|
ValueErrorr ©Úvaluer; r; r< Úfrom_key_val_list s
|
r c C s@ | dkr dS t | ttttfr&tdt | tr8| ¡ } 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 ) ra r r r r. r r r> Úlistr r; r; r< Úto_key_val_list s
|
r c C sX g }t | D ]F}|dd
|dd
kr4dkrHn nt|dd
}| |¡ 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 rq ú")Ú_parse_list_headerÚunquote_header_valueÚappend)r ÚresultÚitemr; r; r< Úparse_list_header= s ( r c C sx i }t | D ]f}d|kr"d||< q | dd¡\}} | 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
|
ú=Nr rq r )r r1 r )r r r ro r; r; r< Úparse_dict_header] s (
|
r c C s\ | rX| d | d kr 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 rq r r NrH z\\ú\z\")r2 )r Ú is_filenamer; r; r< r s
|
$ r c C s i }| D ]}|j ||j< q|S )zReturns a key/value dictionary from a CookieJar.
|
|
:param cj: CookieJar object to extract cookies from.
|
:rtype: dict
|
)r ro )Ú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 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=["\']*(.+?)["\'>])rO rP ÚDeprecationWarningr3 Úcompiler5 Úfindall)ÚcontentÚ
|
charset_reÚ pragma_reÚxml_rer; r; r< Úget_encodings_from_content³ s ü
|
ÿþr§ c
|
C s | d¡}|d ¡ |dd
}}i }d}|D ]`}| ¡ }|r0|d }}| d¡} | dkr|d|
|¡}|| d d
|¡}||| ¡ < 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 r Nz"' Tr rq )r1 Ú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 sD | d¡}|sdS t|\}}d|kr4|d d¡S d|kr@dS dS )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® r; r; r< Úget_encoding_from_headersà s
|
r¹ c c sj |j dkr | D ]
|
}|V qdS t |j ¡dd}| D ]}| |¡}|r4|V q4|jddd}|rf|V dS )zStream decodes a iterator.Nr2 ©Úerrorsó T)Úfinal)ÚencodingÚcodecsÚgetincrementaldecoderrb )ÚiteratorÚrr ÚdecoderÚchunkÚrvr; r; r< Ú stream_decode_response_unicodeõ s
|
|
rÆ c c sH d}|dks|dkr t | }|t | k rD| |||
V ||7 }q dS )z Iterate over slices of a string.r N)rC )ÚstringÚ slice_lengthÚposr; r; r< Ú iter_slices s rÊ c C s~ t dt¡ g }t| j}|rLzt| j|W S tk
|
rJ | |¡ Y nX zt| j|ddW S t k
|
rx | j Y S X dS )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.)r2 rº N)
|
rO rP r r¹ r¸ r r£ Ú UnicodeErrorr Ú TypeError)r Útried_encodingsr¾ r; r; r< Úget_unicode_from_response s ü
|
rÎ zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c C sÄ | d¡}tdt|D ] }|| dd
}t|dkr¨| ¡ r¨ztt|d}W n tk
|
rr td| Y nX |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
|
ú%r r rH é z%Invalid percent-escape sequence: '%s'NÚ )
|
r1 ÚrangerC ÚisalnumÚchrr. r r ÚUNRESERVED_SETrx )ÚuriÚpartsÚiÚhÚcr; r; r< Úunquote_unreserved: s
|
rÛ c C s@ d}d}zt t| |dW S tk
|
r: t | |d Y S X dS )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_uriR s rß c C sl t 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=Lr rw )ÚstructÚunpackÚsocketÚ inet_atonr1 Údotted_netmaskr. )ÚipÚnetÚipaddrÚnetaddrÚbitsÚnetmaskÚnetworkr; r; r< Úaddress_in_networkh s
|
rì c C s& ddd| > d A }t t d|¡¡S )zConverts 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ä w s rä c C s, zt | ¡ W n t jk
|
r& Y dS X dS )z
|
:rtype: bool
|
FT)râ rã Úerror)Ú string_ipr; r; r< Úis_ipv4_address s
|
ró c C s | d¡dkrzt| d¡d }W n tk
|
r: Y dS X |dk sL|dkrPdS zt | d¡d ¡ W q tjk
|
r Y dS X ndS dS )zV
|
Very simple check of the cidr format in no_proxy variable.
|
|
:rtype: bool
|
rw r Frí r T)Úcountr. r1 r râ rã rñ )Ústring_networkrð r; r; r< Ú is_valid_cidr s
|
rö c c sT |dk }|r"t j | ¡}|t j| < z
|
dV W 5 |rN|dkrDt j| = n
|
|t j| < X dS )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)rK Úenvironr· )Úenv_namer Ú value_changedÚ old_valuer; r; r< Ú set_environ¥ s
|
|
|
rû c
|
C s* dd }|}|dkr |d}t | }|jdkr2dS |rÖdd | dd ¡ d
|
¡D }t|jr|D ]0}t|rt|j|r dS q`|j|kr` dS q`nB|j}|jr°|d |j¡7 }|D ] }|j |¡sÎ| |¡r´ dS q´t
|
d|6 zt |j}W n t t jfk
|
r d }Y nX W 5 Q R X |r&dS d S ) zL
|
Returns whether we should bypass proxies or not.
|
|
:rtype: bool
|
c S s t j | ¡pt j | ¡ ¡S ©N)rK r÷ r· Úupper)Úkr; r; r< Ú<lambda>Ã r¼ z'should_bypass_proxies.<locals>.<lambda>NÚno_proxyTc s s | ]}|r|V qd S rü r; )Ú.0r6 r; r; r< Ú <genexpr>Ó s z(should_bypass_proxies.<locals>.<genexpr>ú rÑ ú,z:{}F)r
|
Úhostnamer2 r1 ró rö rì Úportr^ Úendswithrû r rÌ râ Úgaierror) rf r Ú get_proxyÚ no_proxy_argÚparsedÚproxy_ipÚhost_with_portr6 Úbypassr; r; r< Úshould_bypass_proxies» s@
|
ÿ
|
|
|
r c C s t | |dri S t S dS )zA
|
Return a dict of environment proxies.
|
|
:rtype: dict
|
)r N)r r )rf r r; r; r< Úget_environ_proxiesø s r c C st |pi }t | }|jdkr.| |j| d¡¡S |jd |j |jd|j dg}d}|D ]}||krV|| } qpqV|S )zSelect 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)rf ÚproxiesÚurlpartsÚ
|
proxy_keysÚproxyÚ proxy_keyr; r; r< Ú select_proxy s
|
ür úpython-requestsc C s d| t f S )zO
|
Return a string representing the default user agent.
|
|
:rtype: str
|
z%s/%sr )ro r; r; r< Údefault_user_agent s r c C s t t d d¡dddS )z9
|
:rtype: requests.structures.CaseInsensitiveDict
|
z, )ÚgzipÚdeflatez*/*z
|
keep-alive)z
|
User-AgentzAccept-EncodingÚAcceptÚ
|
Connection)r r rx r; r; r; r< Údefault_headers' s ür c
|
C sÎ g }d}| |¡} | s|S t d| ¡D ]¢}z| dd¡\}}W n tk
|
r\ |d }}Y nX d| d¡i}| d¡D ]F}z| d¡\}} W n tk
|
r¦ Y q¾Y nX | |¡|| |¡< 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% r rÑ rf z<> '"r )r¨ r3 r1 r r ) r ÚlinksÚ replace_charsÚvalrf r® Úlinkr± r² r; r; r< Úparse_header_links3 s&
|
r$ ú rZ rH é c C sÐ | dd
}|t jt jfkr dS |dd
t jkr6dS |dd
t jt jfkrRdS | t¡}|dkrhd S |dkr|ddd
tkrd
|
S |d dd
tkrd S |dkrÌ|dd
t kr¸d S |d d
t krÌdS dS )z
|
:rtype: str
|
Né zutf-32r& z utf-8-sigrH zutf-16r zutf-8z 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*
|
r3 c C s8 t | |\}}}}}}|s$|| }}t||||||fS )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 )rf Ú
|
new_schemer rc r\ r® ÚqueryÚfragmentr; r; r< Úprepend_scheme_if_needed~ s
|
r7 c C sB t | }zt|jt|jf}W n ttfk
|
r< d}Y nX |S )z{Given a url with authentication components, extract them into a tuple of
|
username,password.
|
|
:rtype: (str,str)
|
)rÑ rÑ )r
|
r ÚusernameÚpasswordre rÌ )rf r Úauthr; r; r< Úget_auth_from_url s
|
r; s ^\S[^\r\n]*$|^$z^\S[^\r\n]*$|^$c C sf | \}}t |trt}nt}z| |¡s4td| W n* tk
|
r` td||t|f Y nX dS )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)ra r Ú_CLEAN_HEADER_REGEX_BYTEÚ_CLEAN_HEADER_REGEX_STRr4 r rÌ Útype)r« ro r Úpatr; r; r< Úcheck_header_validity¤ s
|
|
ÿr@ c C sF t | \}}}}}}|s"|| }}| dd¡d }t|||||dfS )zW
|
Given a url remove the fragment and the authentication part.
|
|
:rtype: str
|
ú@r rq rÑ )r
|
Úrsplitr )rf r rc r\ r® r5 r6 r; r; r< Ú urldefragauth¹ s
|
|
rC c C s` t | jdd}|dk rTt| jtrTz|| j W q\ ttfk
|
rP tdY q\X ntddS )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.)rs Úbodyra Ú_body_positionr rQ r0 r )Úprepared_requestÚ body_seekr; r; r< Ú rewind_bodyÊ s rH )F)F)N)r )bÚ__doc__r¿ Ú
|
contextlibrI rK r3 râ rà Úsysr} rO ry Ú collectionsr r rÑ r Ú_internal_utilsr Úcompatr r r r
|
r r r r r r r r r r r r Úcookiesr Ú
|
structuresr Ú
|
exceptionsr r r r r[ ÚwhereÚDEFAULT_CA_BUNDLE_PATHÚ DEFAULT_PORTSÚplatformr= rA rV rn rv r 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$ Úencoder- r. r/ r3 r7 r; r¡ r< r= r@ rC rH r; r; r; r< Ú<module> s @
|
' =
|
3 #
|
|
%ÿ
|
=
|
|
&
|
|
|
|
