ZhudZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z ddlmZddlmZddlmZddlmZdd lmZmZmZmZmZmZmZmZmZmZm 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-ej\Z/dddZ0ejbdk(rdZ2dZdZ3dZ4d@dZ5dZ6dZ7dZ8dZ9dZ:dZ;d@dZd Z?d!Z@d"ZAd#ZBd$ZCd%ZDeEd&ZFd'ZGd(ZHd)ZId*ZJd+ZKd,ZLejd-ZNd.ZOdAd/ZPd0ZQdBd1ZRd2ZSd3ZTd4jd5ZVeVd6zZWeVd7zZXd8ZYd9ZZd:Z[ejd;Z]ejd<Z^d=Z_d>Z`d?Zay)Cz 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)quoteurlparsebytesstrunquote getproxies proxy_bypass urlunparse basestring integer_typesis_py3proxy_bypass_environmentgetproxies_environmentMappingcookiejar_from_dict)CaseInsensitiveDict) InvalidURL InvalidHeaderFileModeWarningUnrewindableBodyError)z.netrc_netrcPi)httphttpswin32c  trddl}nddl} |j |j d}t |j|dd}|j|dd}|r|sy|jd}|D]j}|dk(rd|vry |jdd }|jd d }|jd d}tj||tjsjy y#t$rYywxYw#t$rYywxYw)NrFz;Software\Microsoft\Windows\CurrentVersion\Internet Settings ProxyEnable ProxyOverride;z.Tz\.*z.*?)rwinreg_winreg ImportErrorOpenKeyHKEY_CURRENT_USERint QueryValueExOSErrorsplitreplacerematchI)hostr+internetSettings proxyEnable proxyOverridetests ]/mounts/lovelace/software/anaconda3/envs/py312/lib/python3.12/site-packages/requests/utils.pyproxy_bypass_registryr>0s+ ( %~~f.F.FN P f112B.;==>@AK#//0@0?AABDM- &++C0 ! Dy d?<<U+D<<U+D<<T*DxxdBDD) ?    s#C'AC6' C32C36 DDcBtr t|St|S)zReturn True, if the host should be bypassed. Checks proxy settings gathered from the environment, if specified, or the registry. )rrr>)r8s r=rrWs " #+D1 1(. .c>t|dr|j}|S)z/Returns an internal sequence dictionary update.items)hasattrrB)ds r=dict_to_sequencerEcsq' GGI Hr@cd}d}t|dr t|}n~t|dr |j}net|drY |j}tj|j }d|j vrtjdt t|drW |j}t|dr:|8 |jdd |j}|j|xsd|d}t!d||z S#tj$rYwxYw#ttf$rd}Y?wxYw#ttf$r||}YXwxYw) Nr__len__lenfilenoba%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.tellseek)rCrHrIosfstatst_sizemodewarningswarnrioUnsupportedOperationrKrLr2IOErrormax)o total_lengthcurrent_positionrIs r= super_lenr[ls`Lq)1v E uu H  XXZF88F+33L!&&  . $q& % vvx q&!l&: %FF1aL#$668LFF+0q1 q,!11 22[&&   N )%#$L%%! 0 '#/  0s6D(E7D*D'&D'*D>=D>EEc> ddlm}m}d}tD]T} tjj dj |}tjj|sR|}n|yt|}d}t|tr|jd}|jj|d} ||j| } | r| drdnd} | | | dfSy#t$rYywxYw#|t f$r|rYywxYw#t"t$f$rYywxYw) z;Returns the Requests tuple auth for a given url from netrc.r)netrcNetrcParseErrorNz~/{}:asciirrM)r]r^ NETRC_FILESrNpath expanduserformatKeyErrorexistsr isinstancer decodenetlocr3authenticatorsrVr-AttributeError) url raise_errorsr]r^ netrc_pathflocrisplitstrr8rlogin_is r=get_netrc_authrts6- 0  A gg((q)9:ww~~c"      c] c3 w/Hyyx(+ :&55d;F &q 1qw333   : )    (   s_D .C&D $D ,A D 9+C6& C3/D 2C33D 6DD DD DDct|dd}|rBt|tr1|ddk7r(|ddk7rtjj |Syyyy)z0Tries to guess the filename of the given object.nameNr<>)getattrrgrrNrbbasename)objrvs r=guess_filenamer}sV 3 %D D*-$q'S. HOww%% 3A-r@ctjj|r|Stjj|\}}|rvtjj|sWtjj|\}}dj ||g}|r tjj|sWt j |s|St j|}||jvr|Stj}tjj|g|jd}tjj|s|j||}|S)zReplace 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. /)rb) rNrbrfr3joinzipfile is_zipfileZipFilenamelisttempfile gettempdirextract)rbarchivememberprefixzip_filetmpextracted_paths r=extract_zipped_pathsrs  ww~~d ggmmD)OGV "''..1''--066*+ "''..1   g & w'H X&&((     CWW\\#: S(9:N 77>>. )!))&s); r@ct|yt|ttttfr t dt |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)rgr r boolr0 ValueErrorrvalues r=from_key_val_listrs6$ }%#udC01FGG u r@c|yt|ttttfr t dt|t r|j}t|S)aTake 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) rgr r rr0rrrBlistrs r=to_key_val_listrsJ" }%#udC01FGG%!  ;r@cg}t|D]5}|dd|ddcxk(rdk(rnnt|dd}|j|7|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 Nrrx")_parse_list_headerunquote_header_valueappend)rresultitems r=parse_list_headerr=sY.F"5) 8tBCy 'C ''Qr 3D d Mr@ci}t|D]H}d|vrd||< |jdd\}}|dd|ddcxk(rdk(rnnt|dd}|||<J|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 =Nrrxr)rr3r)rrrrvs r=parse_dict_headerr]s},F"5) d?F4L jja( e !9bc )c )(q5Et  Mr@c|rF|d|dcxk(rdk(r5n|S|dd}|r|dddk7r"|jddjd dS|S) zUnquotes 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 rrxrrNrMz\\\z\")r4)r is_filenames r=rrsd qU2Y-#- La eBQi61==.66ucB B Lr@cJi}|D]}|j||j<|S)zReturns a key/value dictionary from a CookieJar. :param cj: CookieJar object to extract cookies from. :rtype: dict )rrv)cj cookie_dictcookies r=dict_from_cookiejarrs2K0#)<< FKK 0 r@ct||S)zReturns 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)rrs r=add_dict_to_cookiejarrs {B //r@c^tjdttjdtj }tjdtj }tjd}|j ||j |z|j |zS)zlReturns encodings from given content string. :param content: bytestring to extract encodings from. zIn 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!])flagsz+]z$^<\?xml.*?encoding=["\']*(.+?)["\'>])rRrSDeprecationWarningr5compiler7findall)content charset_re pragma_rexml_res r=get_encodings_from_contentrs  MM -   @MJ IQSQUQUVI ZZ? @F   w '   g & ' NN7 # $%r@cH|jd}|dj|dd}}i}d}|D]m}|j}|s|d}}|jd} | dk7r+|d| j|}|| dzdj|}|||j<o||fS) zReturns content type and parameters from given header :param header: string :return: tuple containing content type and dictionary of parameters r'rrNz"' Trrx)r3stripfindlower) headertokens content_typeparams params_dictitems_to_stripparamkeyrindex_of_equalss r=_parse_content_type_headerrs\\# F!!9??,fQRj&LKN-  C#jjoO"$,_-33NCo12399.I',K $-  $$r@c|jd}|syt|\}}d|vr|djdSd|vryy)z}Returns encodings from given HTTP Header Dict. :param headers: dictionary to extract encoding from. :rtype: str z content-typeNcharsetz'"textz ISO-8859-1)getrr)headersrrs r=get_encoding_from_headersrsU;;~.L 5lCL&Fi &&u-- r@c#K|j |D]}|ytj|jd}|D]}|j|}|s||jdd}|r|yyw)zStream decodes a iterator.Nr4errorsr@T)final)encodingcodecsgetincrementaldecoderrh)iteratorrrdecoderchunkrvs r=stream_decode_response_unicoders zz DJ 6f**1::6iHG ^^E " H 4 (B  s AA;!A;c#Kd}||dkr t|}|t|kr||||z||z }|t|kryyw)z Iterate over slices of a string.rN)rH)string slice_lengthposs r= iter_slicesrsW C|q06{ F S|+,, | F s AAAc>tjdtg}t|j}|r t |j |S t |j |dS#t$r|j|Y5wxYw#t$r|j cYSwxYw)zReturns 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 zIn 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.)r4r) rRrSrrrr r UnicodeErrorr TypeError)rtried_encodingsrs r=get_unicode_from_responsers MM -   O)3H -qyy(+ + 199hy99  -  " "8 , - yys#A$ B$BBBBzBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c|jd}tdt|D]l}||dd}t|dk(rI|jr9 t t |d}|tvr|||ddz||<Vd||z||<bd||z||<ndj|S#t $rtd|zwxYw) zUn-escape any percent-escape sequences in a URI that are unreserved characters. This leaves all reserved, illegal and non-ASCII bytes encoded. :rtype: str %rrrMz%Invalid percent-escape sequence: '%s'N) r3rangerHisalnumchrr0rrUNRESERVED_SETr)uripartsihcs r=unquote_unreservedr:s IIcNE 1c%j ! & !HQqM q6Q;199; NAr ON"uQx|+aq>aU1X~E!H & 775> N !H1!LMM Ns B''B?cpd}d} tt||S#t$rt||cYSwxYw)zRe-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!#$&'()*+,/:;=?@[]~)safe)r rr)rsafe_with_percentsafe_without_percents r= requote_urirRsJ/0 5',3DEE 5S344 5s 55c rtjdtj|d}|j d\}}tjdtjt t |d}tjdtj|d|z}||z||zk(S)zThis 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=Lrr)structunpacksocket inet_atonr3dotted_netmaskr0)ipnetipaddrnetaddrbitsnetmasknetworks r=address_in_networkrhs]]4!1!1"!5 6q 9FIIcNMGTmmD&"2"2>#d)3L"MNqQGmmD&"2"27";I)r inet_ntoarpack)maskrs r=rrws7 b4i1, ,D   FKKd3 44r@cb tj|y#tj$rYywxYw)z :rtype: bool FT)rrerror) string_ips r=is_ipv4_addressr s2#  <<s ..c |jddk(rR t|jdd}|dks|dkDry t j |jddyy#t$rYywxYw#tj $rYywxYw)zV Very simple check of the cidr format in no_proxy variable. :rtype: bool rrFrrT)countr0r3rrrr )string_networkrs r= is_valid_cidrrs C A% ~++C034D !8tby    ^11#6q9 :   ||  s"A('A7( A43A47B  B c#8K|du}|r2tjj|}|tj|< d|r(tj|=y|tj|<yy#|r(tj|=w|tj|<wwxYww)zSet 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)rNenvironr)env_namer value_changed old_values r= set_environrs%MJJNN8, $ 81  JJx('0 8$ = JJx('0 8$ s9BA++B+,BBcd}|}||d}t|}|jy|rd|jddjdD}t |jr=|D]7}t |rt |j|s%y|j|k(s7ynk|j}|jr|d j|jz }|D]0}|jj|s|j|s0ytd|5 t|j}dddryy #ttjf$rd }Y)wxYw#1swY.xYw) zL Returns whether we should bypass proxies or not. :rtype: bool ctjj|xs-tjj|jSN)rNrrupper)ks r=z'should_bypass_proxies..s+"**..+Hrzz~~aggi/Hr@Nno_proxyTc3&K|] }|s| ywr).0r8s r= z(should_bypass_proxies..s TD s r,z:{}F)r hostnamer4r3r rrportrdendswithrrrrgaierror) rlr get_proxy no_proxy_argparsedproxy_iphost_with_portr8bypasss r=should_bypass_proxiesr.sbIILZ( c]F  %--c26<>EEEEE(c4t||riStS)zA Return a dict of environment proxies. :rtype: dict )r)r.r)rlrs r=get_environ_proxiesr0s S84 |r@c.|xsi}t|}|j+|j|j|jdS|jdz|jz|jd|jzdg}d}|D]}||vs||}|S|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 Nallz://zall://)r r$rscheme)rlproxiesurlparts proxy_keysproxy proxy_keys r= select_proxyr9s mG}H {{8??GKK,>?? %("3"338$$$ J E  I&E  L  Lr@c|dtS)zO Return a string representing the default user agent. :rtype: str rr)rvs r=default_user_agentr;s K ((r@cPttdjddddS)z9 :rtype: requests.structures.CaseInsensitiveDict z, )gzipdeflatez*/*z keep-alive)z User-AgentzAccept-EncodingAccept Connection)rr;rrr@r=default_headersrA's/ (*99%89"   r@cg}d}|j|}|s|Stjd|D]} |jdd\}}d|jdi}|jdD]:} |jd\}}|j|||j|<<|j ||S#t$r|d}}YwxYw#t$rY4wxYw) zReturn a list of parsed link headers proxies. i.e. Link: ; rel=front; type="image/jpeg",; rel=back;type="image/jpeg" :rtype: list z '"z, * '"r)rr5r3rr) rlinks replace_charsvalrlrlinkrrs r=parse_header_linksrG3s EM KK &E  xx& "))C+KCsyy*+\\#& HE "[[- U.3[[-GD=) *  H  T!$ L "rC "  s#B?1C? CC CCr`rMc|dd}|tjtjfvry|ddtjk(ry|ddtjtj fvry|j t}|dk(ry |dk(r |dddtk(ry |d ddtk(ry |dk(r|ddtk(ry |d dtk(ryy)z :rtype: str Nzutf-32rIz utf-8-sigrMzutf-16rzutf-8z utf-16-berz utf-16-lez utf-32-bez utf-32-le) r BOM_UTF32_LE BOM_UTF32_BEBOM_UTF8 BOM_UTF16_LE BOM_UTF16_BEr_null_null2_null3)datasample nullcounts r=guess_json_utfrW^s"1XF &%%v':':;; bqzV__$ bqzf))6+>+>?? U#IA~A~ #A#;&  !$Q$<6 !A~ "1:  !":  r@cVt||\}}}}}}|s||}}t||||||fS)zGiven 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)rl new_schemer3rirbrqueryfragments r=prepend_scheme_if_neededr\~sC 5=S*4M1FFD&% V vvtVUHE FFr@ct|} t|jt|jf}|S#tt f$rd}Y|SwxYw)z{Given a url with authentication components, extract them into a tuple of username,password. :rtype: (str,str) )rr)r rusernamepasswordrkr)rlr*auths r=get_auth_from_urlrasU c]F('&//*BC K I & Ks*9A As^\S[^\r\n]*$|^$z^\S[^\r\n]*$|^$c |\}}t|trt}nt} |j |st d|zy#t $rt d|d|dt|wxYw)zVerifies 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: %szValue for header {z: z$} must be of type str or bytes, not N)rgr _CLEAN_HEADER_REGEX_BYTE_CLEAN_HEADER_REGEX_STRr6rrtype)rrvrpats r=check_header_validityrgs{KD%%&%Jyy Y\` `a a J/3UDKIJ JJs A'A+c~t|\}}}}}}|s||}}|jddd}t|||||dfS)zW Given a url remove the fragment and the authentication part. :rtype: str @rrxr)r rsplitr)rlr3rirbrrZr[s r= urldefragauthrksU 5=SM1FFD&% V ]]3 "2 &F vvtVUB? @@r@ct|jdd}|.t|jtr ||jytd#t t f$r tdwxYw)zfMove file pointer back to its recorded starting position so it can be read again on redirect. rLNz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)rzbodyrg_body_positionrrVr2r)prepared_request body_seeks r= rewind_bodyrqsy(--vt &55 6 $$QRR ! >')=> > >s AA.)Fr)zpython-requests)b__doc__r contextlibrTrNr5rrsysrrRr collectionsrrrr_internal_utilsrcompatr rr r r r rrrrrrrrrrcookiesr structuresr exceptionsrrrrrawhereDEFAULT_CA_BUNDLE_PATH DEFAULT_PORTSplatformr>rEr[rtr}rrrrrrrrrrrrrr frozensetrrrrrr rcontextmanagerrr.r0r9r;rArGencoderQrRrSrWr\rarrcrdrgrkrqrr@r=rs #$-9????)+GG# $c* <<7%N / :3z0 f&@6<@F2 0%(%2*$!JMO05, 550 11*:z 4) "L  g  @G" "&2::&;<$"**%78J*A" Sr@