+ i Rt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI H t ^RIHtHt^RIHt^RIHt^RIHtHtHtHt^RIHtHtHtHtHtHtH t ^RIH!t"^R IH#t#H$t$H%t%H&t&H't'H(t(H)t)^R I*H+t+^R I,H-t-H.t.H/t/H0t0^R I1H2t2RBt3]Ph!4t5R ^PRR/t6RPo]Pp!R]!RR7R,44t9]PtR8XdRt;Rt#RtRt?Rt@]PR4tBRtCRtDR tER!tFRCR"ltGR#tHR$tIR%tJR&tKR'tLR(tMR)tNR*tO]P!RD4tQR+tRR,tSR-tTR.tUR/tVR0tW]PR14tXR2tYRER3ltZR4t[RFR5lt\RGR6lt]R7t^R8t_R9PR:4ta]a^,tb]a^,tcR;tdR<teR=tfR>tgR?thR@tiRAtjR#)Hz 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_STRHEADER_VALIDATORSto_native_string)Mapping basestringbytes getproxiesgetproxies_environment integer_types is_urllib3_1)parse_http_list) proxy_bypassproxy_bypass_environmentquotestrunquoteurlparse urlunparsecookiejar_from_dict)FileModeWarning InvalidHeader InvalidURLUnrewindableBodyError)CaseInsensitiveDicthttphttpsiz, z,\s*T)accept_encodingzaccept-encodingwin32cn^RIpTPTPR4p\ TP TR4^,4pTP TR4^,pT'd T'gR#TPR4p\RT4pTFxpTR8Xd RT9dR #TPRR 4pTPR R 4pTPR R4p\P!YP\P4'gKwR # R# \dR#i;i \ \3dR#i;i)NFz;Software\Microsoft\Windows\CurrentVersion\Internet Settings ProxyEnable ProxyOverride;z.Tz\.*z.*?)winreg ImportErrorOpenKeyHKEY_CURRENT_USERint QueryValueExOSError ValueErrorsplitfilterreplacerematchI)hostr.internetSettings proxyEnable proxyOverridetests& T/Users/ahmad/.openclaw/workspace/venv/lib/python3.14/site-packages/requests/utils.pyproxy_bypass_registryrBMs!   %~~((N   f112BMRSTUVK"//0@/RSTUM- &++C0 t]3 !Dy d?<<U+D<<U+D<<T*DxxBDD))"C  $  s#D AD DDD43D4cN\4'd \V4#\V4#)zReturn True, if the host should be bypassed. Checks proxy settings gathered from the environment, if specified, or the registry. )rrrB)r<s&rArrss# " # #+D1 1(. .cJ\VR4'dVP4pV#)z/Returns an internal sequence dictionary update.items)hasattrrF)ds&rAdict_to_sequencerIs!q' GGI HrDc|Rp^p\'g(\V\4'dVPR4p\ VR4'd \ V4pM\ VR4'dVP pMo\ VR4'd^VP 4p\P!V4PpRVP9d\P!R\4\ VR4'dfVP#4p\ VR4'dCVf?VP%^^4VP#4pTP%T;'g^4Vf^p\)^W, 4# \P\ 3dLi;i \&d^pLHi;i \&d TeTpL_i;i) Nutf-8__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)r isinstancerencoderGrMrNosfstatst_sizemodewarningswarnrioUnsupportedOperationAttributeErrorrPrQr4max)o total_lengthcurrent_positionrNs& rA super_lenrasL !get_netrc_auth..s9[Rs8[s)NetrcParseErrornetrc)rTenvironget NETRC_FILESrkrjpath expanduserexistsrhostnameauthenticatorsr4r/r\) url raise_errors netrc_filenetrc_locationsrjrk netrc_pathrglocrir<_netrclogin_is && rAget_netrc_authr}s (J%-9[9  0  A''$$Q'Cww~~c""  !    c]{{ :&55d;F%ayy!a33 )    (   sHAD DD/-C4C44D D D DDD&%D&c\VRR4pV'dX\V\4'd@V^,R8wd0VR,R8wd \PP V4#R#R#R#R#)z0Tries to guess the filename of the given object.nameN<>)getattrrRr rTrobasename)objrs& rAguess_filenamersW 3 %D 4,,aCDHPSOww%%ET,trDc\PPV4'dV#\PPV4wrV'dd\PPV4'g?\PPV4wrV'gMRP W2.4pKk\ P !V4'gV#\ P!V4pW$P49dV#\P!4p\PP WRPR4R,4p\PPV4'g?\V4;_uu_4pVPVPV44RRR4V#V# +'giT#;i)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. /Nr)rTrorqr6joinzipfile is_zipfileZipFilenamelisttempfile gettempdir atomic_openwriteread)roarchivememberprefixzip_filetmpextracted_path file_handlers& rAextract_zipped_pathsrs2  ww~~d ggmmD)OG "''..11''--0 6*+   g & & w'H &&((     CWW\\#||C'8'<=N 77>>. ) )  ( (L   x}}V4 5) >) ( s !F-- F> c#r"\P!\PP V4R7wr\P !VR4;_uu_4pVxRRR4\P !W 4R# +'giL(;i \d\P!T4hi;i5i)z-Write a file to the disk in an atomic fashion)dirwbN) rmkstemprTrodirnamefdopenr8 BaseExceptionremove)filenametmp_descriptortmp_name tmp_handlers& rArr's} (//BGGOOH4MNN YY~t , ,  - 8&- ,  ( s47B7BA>B<B7> B B#B44B7cVfR#\V\\\\34'd \ R4h\ V4#)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)rRrrboolr2r5rvalues&rAfrom_key_val_listr4s9$ }%#udC011FGG u rDcVfR#\V\\\\34'd \ R4h\V\ 4'dVP4p\V4#)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) rRrrrr2r5r rFlistrs&rAto_key_val_listrOsP" }%#udC011FGG%!!  ;rDc.p\V4F>pVR,VRRu;8XdR8XdMM\V^R4pVPV4K@ V#)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 NNN"r)_parse_list_headerunquote_header_valueappend)rresultitems& rAparse_list_headerrmsR.F"5) 8tBCy 'C ''Qr 3D d* MrDc/p\V4FRpRV9dRW&KVPR^4wr0VR,VRRu;8XdR8XdMM\V^R4pWV&KT V#)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 =Nrrr)rr6r)rrrrs& rAparse_dict_headerrsp,F"5) d?FL jja(  9bc )c )(q5Et * MrDcV'd_V^,VR,u;8XdR8XdBMV#V^RpV'dVR,R8wd#VPRR4PRR4#V#)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 rNNz\\\z\"r)r8)r is_filenames&&rArrsb qU2Y-#- La eBi61==.66ucB B LrDcZVUu/uFqPVPbK ppV#uupi)ztReturns a key/value dictionary from a CookieJar. :param cj: CookieJar object to extract cookies from. :rtype: dict )rr)cjcookie cookie_dicts& rAdict_from_cookiejarrs.<>>2;; ,2K> ?s(c\W4#)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&&rAadd_dict_to_cookiejarrs { //rDcv\P!R\4\P!R\P R7p\P!R\P R7p\P!R4pVP V4VP V4,VP V4,#)zdReturns 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=["\']*(.+?)["\'>])rXrYDeprecationWarningr9compiler;findall)content charset_re pragma_rexml_res& rAget_encodings_from_contentrs  MM 1  @MJ IQSQUQUVI ZZ? @F 7#   G $ % .. ! "rDclVPR4pV^,P4VR,r2/pRpVFxpVP4pV'gKTRrVPR4p V R8wd/VRV PV4pWi^,RPV4pWVP4&Kz W$3#)zReturns content type and parameters from given header :param header: string :return: tuple containing content type and dictionary of parameters r*rNNz"' TrNr)r6stripfindlower) headertokens content_typeparams params_dictitems_to_stripparamkeyrindex_of_equalss & rA_parse_content_type_headerrs\\# F!!9??,fRj&KN  5#jjoO"$,_-33NC134::>J', $  $$rDcVPR4pV'gR#\V4wrRV9dVR,PR4#RV9dR#RV9dR#R#) zqReturns encodings from given HTTP Header Dict. :param headers: dictionary to extract encoding from. :rtype: str z content-typeNcharsetz'"textz ISO-8859-1zapplication/jsonrK)rmrr)headersrrs& rAget_encoding_from_headersrs^;;~.L 5lCLFi &&u-- \)*rDc#&"VPf TRjxL R#\P!VP4!RR7pVF"pVPV4pV'gKVxK$ VPRRR7pV'dVxR#R#Lx5i)zStream decodes an iterator.Nr8errorsrDT)final)encodingcodecsgetincrementaldecoderdecode)iteratorrdecoderchunkrvs&& rAstream_decode_response_unicoder*s~ zz**1::6iHG ^^E " 2H 4 (B   sBBAB$"B Bc#"^pVeV^8:d \V4pV\V48dWW!,xW!, pK&R#5i)z Iterate over slices of a string.N)rM)string slice_lengthposs&& rA iter_slicesr;sG C|q06{ F 3-..  sAAcT\P!R\4.p\VP4pV'd\ VP V4#\ VP VRR7# \dTPT4L7i;i \dTP u#i;i)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.)r8r) rXrYrrrrr UnicodeErrorr TypeError)rtried_encodingsrs& rAget_unicode_from_responserEs MM 1  O)3H -qyy(+ + 199hy99  -  " "8 , - yys#A+B +B  B  B'&B'cVPR4p\^\V44FpW,R,p\V4^8XdaVP4'dK\ \ V^44pT\9dYAT,R,,Y&KsRY, 2Y&KRW, 2W&K RPV4# \ d\RT R24hi;i)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 %:r'rNz"Invalid percent-escape sequence: '':rNN) r6rangerMisalnumchrr2r5rUNRESERVED_SETr)uripartsihcs& rAunquote_unreservedr rs IIcNE 1c%j ! HSM q6Q;199;; LAr ON"Qx|+uxj>58*~EH" 775> L #EaS!JKK Ls C  C&crRpRp\\V4VR7# \d\YR7u#i;i)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)rr r)rsafe_with_percentsafe_without_percents& rA requote_urirsG/0 5',3DEE 5S44 5s 66c \P!R\P!V44^,pVP R4wr4\P!R\P!\ \ V4444^,p\P!R\P!V44^,V,pW%,We,8H#)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=Lr)structunpacksocket inet_atonr6dotted_netmaskr2)ipnetipaddrnetaddrbitsnetmasknetworks&& rAaddress_in_networkrs]]4!1!1"!5 6q 9FIIcNMGmmD&"2"2>#d)3L"MNqQGmmD&"2"27";I)r inet_ntoarpack)maskrs& rArrs7 b4i1, ,D   FKKd3 44rDcX\P!V4R# \dR#i;i)z :rtype: bool FT)rrr4) string_ips&rAis_ipv4_addressr&s.#  s  ))c<VPR4^8Xdb\VPR4^,4pT^8gT^ 8dR#\P !TPR4^,4R#R# \dR#i;i \ dR#i;i)zJ Very simple check of the cidr format in no_proxy variable. :rtype: bool rFT)countr2r6r5rrr4)string_networkr#s& rA is_valid_cidrr*s C A% ~++C034D !8tby    ^11#6q9 :     s#!A: ,B : B B  BBc#j"VRJpV'd3\PPV4pV\PV&RxV'd-Xf\PVR#V\PV&R#R# T'd+Xf\PTiT\PT&ii;i5i)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)rTrlrm)env_namer value_changed old_values&& rA set_environr/s%MJJNN8, $ 81  JJx('0 8$ = JJx('0 8$ s?B3A<6B3<4B00B3clRpTpVf V!R4p\V4pVPfR#V'Ed RVPRR4PR44p\ VP4'dQVFIp\ V4'd"\ VPV4'dR#K5VPV8XgKHR# MxVPpVP'dVR VP 2, pVF>pVPPV4'gVPV4'gK=R# \RV4;_uu_4\VP4pRRR4X'dR#R # \\P3dR pL3i;i +'giL?;i) z@ Returns whether we should bypass proxies or not. :rtype: bool c\PPV4;'g.\PPVP44#N)rTrlrmupper)rs&rA get_proxy(should_bypass_proxies..get_proxys0zz~~c"AAbjjnnSYY[&AArDNno_proxyTc38"TFq'gK VxK R#5ir2re)rfr<s& rArh(should_bypass_proxies.. sR%ITTDD%Is   r,:F)rrrr8r6r&r*rportendswithr/rrrgaierror) rtr6r4 no_proxy_argparsedproxy_iphost_with_portr<bypasss && rAshould_bypass_proxiesrDseB LZ( c]F xSX%5%5c2%>%D%DS%IR 6?? + +$ **)&//8DD#E__0 %$__N{{{Afkk]"33 ??++D11^5L5LT5R5R ! Z . . !&//2F /  6??+ F  / .s*F#FF F#F  F## F3 c>\WR7'd/#\4#)z5 Return a dict of environment proxies. :rtype: dict r6)rDr)rtr6s&&rAget_environ_proxiesrG0s S44 |rDcdT;'g/p\V4pVPf,VPVPVPR44#VPR,VP,VPRVP,R.pRpVFpWQ9gK W,pV# V#)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://)rrrrmscheme)rtproxiesurlparts proxy_keysproxy proxy_keys&& rA select_proxyrP<s mmG}H {{8??GKK,>?? %("3"338$$$ J E  &E  L  LrDcXVeTM/pVPp\V4PpVPR4pVP 4pV'dX\ W5R7'gF\ W5R7pVPWGPR44pV'dVPWH4V#)aThis method takes proxy information from a request and configuration input to resolve a mapping of target proxies. This will consider settings such as 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 r6rFrI)rtrrJrmcopyrDrG setdefault) requestrK trust_envrtrJr6 new_proxiesenviron_proxiesrNs &&& rAresolve_proxiesrXVs!,g"G ++C c] ! !F{{:&H,,.K.sFF-cE##F,?,?,FG   " "6 1 rDcV R\ 2#)zC Return a string representing the default user agent. :rtype: str rr)rs&rAdefault_user_agentrZqs V1[M ""rDc @\R\4R\RRRR/4#)z1 :rtype: requests.structures.CaseInsensitiveDict z User-AgentzAccept-EncodingAcceptz*/* Connectionz keep-alive)r!rZDEFAULT_ACCEPT_ENCODINGrerDrAdefault_headersr_zs/  ,. 6 e ,   rDc.pRpVPV4pV'gV#\P!RV4FpVPR^4wrERVPR4/pVPR4F9pVPR4wrTPT4YhPT4&K; VP V4K V# \dTRrTLi;i \dK:i;i)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)rr9r6r5r) rlinks replace_charsvalrtrlinkrrs & rAparse_header_linksres EM KK &E  xx& "))C+KCsyy*+\\#&E "[[- .3[[-GD=) * '  T!'$ L "r "  s#C7CCC C+*C+asciicVR,pV\P\P39dR#VR,\P8XdR#VR,\P\P 39dR#VP \4pV^8XdR#V^8Xd)VR,\8XdR #VR ,\8XdR #V^8Xd)VR,\8XdR #VR ,\8XdR#R#)z :rtype: str :NNzutf-32:NNz utf-8-sigrzutf-16rK:NNrz utf-16-be:rNrz utf-16-lez utf-32-berz utf-32-leN) r BOM_UTF32_LE BOM_UTF32_BEBOM_UTF8 BOM_UTF16_LE BOM_UTF16_BEr(_null_null2_null3)datasample nullcounts& rAguess_json_utfrvs"XF &%%v':':;; bzV__$ bzf))6+>+>?? U#IA~A~ #;&  $<6 !A~ ":  ":  rDc\V4pVwr4rVrxp VPp V 'gYzrzV'dRPWJ.4p VfTpVfRp\W:VRW34#)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)rnetlocrr) rt new_schemer@rJauthr<r<roqueryfragmentrys && rAprepend_scheme_if_neededr~sk s^F6<3F$d8 ]]F  4.) ~ | vtRA BBrDc\V4p\VP4\VP43pV# \\ 3dRpT#i;i)zoGiven a url with authentication components, extract them into a tuple of username,password. :rtype: (str,str) )rr)rrusernamepasswordr\r)rtr@r{s& rAget_auth_from_urlrsU c]F('&//*BC K I & Ks*9AAc>Vwr\W^4\W^4R#)zVerifies that header parts don't contain leading whitespace reserved characters, or return characters. :param header: tuple, in the format (name, value). N)_validate_header_part)rrrs& rAcheck_header_validityrs KD&*&+rDc :\V\4'd\V,pMB\V\4'd\V,pM\ RV: RV R\ V4 24hVPV4'gV^8XdRMRp\ RV RV: 24hR#)z Header part (z) from z# must be of type str or bytes, not rrzTInvalid leading whitespace, reserved character(s), or return character(s) in header z: N)rRrr rrrtyper:)r header_partheader_validator_index validator header_kinds&&& rArr s+s##*+AB K ' '+,BC K?'&:115k1B0C E  ??; ' ' 6! ;f &&1]"[O E   (rDc\V4wrr4rVV'gY2r2VPR^4R,p\WW4VR34#)zK Given a url remove the fragment and the authentication part. :rtype: str rxrr)rrsplitr)rtrJryrorr|r}s& rA urldefragauthrsG 5=SM1FD%  ]]3 "2 &F vtUB? @@rDc\VPRR4pVe6\VP\4'dV!VP4R#\ R4h \ d \ R4hi;i)z^Move file pointer back to its recorded starting position so it can be read again on redirect. rQNz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)rbodyrR_body_positionrr4r )prepared_request body_seeks& rA rewind_bodyr/sy(--vtrs  #0$ :) ," Wc* ))HHWl489JKL <<7$L / D3N) X&"J   6<@F202%22"$PM 05, 550 11*:z 46# "L  g  @C:  , &A"SrD