&kiD `SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK J r SSKJrJr SSKJr SSKJr SSKJrJrJrJr SS KJrJrJrJrJrJr SS KJ r! SS KJ"r"J#r#J$r$J%r%J&r&J'r'J(r( SS K)J*r* SS K+J,r,J-r-J.r.J/r/ SSK0J1r1 Sr2\Rf"5r4SSS.r5SRm\Rn"S\"SS9S55r8\RrS:XaSr:Sr"Sr;SrSr?\RS 5rAS!rBS"rCS#rDS$rESHS%jrFS&rGS'rHS(rIS)rJS*rKS+rLS,rMS-rN\O"S.5rPS/rQS0rRS1rSS2rTS3rUS4rV\RS55rWS6rXSIS7jrYS8rZSJS9jr[SKS:jr\S;r]S<r^S=RS>5r`\`S?-ra\`S@-rbSArcSBrdSCreSDrfSErgSFrhSGrig)Lz 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)parse_http_list) proxy_bypassproxy_bypass_environmentquotestrunquoteurlparse urlunparsecookiejar_from_dict)FileModeWarning InvalidHeader InvalidURLUnrewindableBodyError)CaseInsensitiveDict)z.netrc_netrcPi)httphttpsz, z,\s*T)accept_encodingzaccept-encodingwin32cDSSKnURURS5n[ UR US5S5nUR US5SnU(aU(dgURS5n[SU5nUHsnUS:XaSU;a g URSS 5nURS S 5nURS S5n[R"XP[R5(dMs g g![a gf=f![ [4a gf=f)NrFz;Software\Microsoft\Windows\CurrentVersion\Internet Settings ProxyEnable ProxyOverride;z.Tz\.*z.*?)winreg ImportErrorOpenKeyHKEY_CURRENT_USERint QueryValueExOSError ValueErrorsplitfilterreplacerematchI)hostr0internetSettings proxyEnable proxyOverridetests 0/usr/lib/python3/dist-packages/requests/utils.pyproxy_bypass_registryrDLs!   %~~((N   f112BMRSTUVK"//0@/RSTUM- &++C0 t]3 !Dy d?<<U+D<<U+D<<T*DxxBDD))"C  $  s#C<AD < D D  DDcL[5(a [U5$[U5$)zReturn True, if the host should be bypassed. Checks proxy settings gathered from the environment, if specified, or the registry. )rrrD)r>s rCrrrs# " # #+D1 1(. .cH[US5(aUR5nU$)z/Returns an internal sequence dictionary update.items)hasattrrH)ds rCdict_to_sequencerK~s!q' GGI HrFc@SnSn[U[5(aURS5n[US5(a [ U5nO[US5(a URnOm[US5(a\UR 5n[ R"U5RnSUR;a[R"S[5 [US5(abUR!5n[US 5(a@Uc=UR#SS 5 UR!5nUR#U=(d S5 UcSn['SX- 5$![R[4a Nf=f![$a SnNAf=f![$a UbUnNVf=f) Nrutf-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) isinstancerencoderIrOrPosfstatst_sizemodewarningswarnrioUnsupportedOperationAttributeErrorrRrSr6max)o total_lengthcurrent_positionrPs rC super_lenrdsL!S HHW q)1v E  uu H   XXZF88F+33L!&&  2$ q& % vvx q&!!l&: %FF1aL#$668LFF+0q1 q,1 22e''8    X%#$L%% 0 '#/  0s68E%F !get_netrc_auth..s9[Rs8[sr)NetrcParseErrornetrcrrT)rWenvironget NETRC_FILESrnrmpath expanduserKeyErrorexistsrhostnameauthenticatorsr6r1r_) url raise_errors netrc_filenetrc_locationsrmrn netrc_pathrjlocrir>r#login_is rCget_netrc_authrs'(J%-9[9' 0  A gg((+ww~~c"" !    c]{{ :&55d;F%ay!a33'   . )    (   s_D C"$"D D D ,4C3" C0,D /C00D 3D D D  D D D c[USS5nU(aI[U[5(a3USS:wa)USS:wa[RR U5$gggg)z0Tries to guess the filename of the given object.nameNr<>)getattrrUrrWrrbasename)objrs rCguess_filenamersW 3 %D 4,,aCDHPSOww%%ET,trFc[RRU5(aU$[RRU5upU(a[RRU5(dh[RRU5upU(dO?SR X2/5nU(a&[RRU5(dMh[ R "U5(dU$[ R"U5nX$R5;aU$[R"5n[RR XRRS5S5n[RRU5(d6[U5nURURU55 SSS5 U$U$!,(df  U$=f)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. /rN)rWrrrur8joinzipfile is_zipfileZipFilenamelisttempfile gettempdir atomic_openwriteread)rrarchivememberprefixzip_filetmpextracted_path file_handlers rCextract_zipped_pathsrsH  ww~~d ggmmD)OG "''..11''--0 6*+ "''..11   g & & w'H &&((     CWW\\#||C'8'<=N 77>>. ) )  (L   x}}V4 5) >) ( s !G Gc#T# [R"[RR U5S9up[R "US5nUv SSS5 [R "X 5 g!,(df  N%=f![a [R"U5 ef=f7f)z-Write a file to the disk in an atomic fashion)dirwbN) rmkstemprWrrdirnamefdopenr: BaseExceptionremove)filenametmp_descriptortmp_name tmp_handlers rCrr+sz (//BGGOOH4MNN YY~t ,  - 8&- ,  ( s44B(BA2B1B(2 B<B"B%%B(cUcg[U[[[[45(a [ S5e[ U5$)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)rUrrboolr4r7rvalues rCfrom_key_val_listr8s9$ }%#udC011FGG u rFcUcg[U[[[[45(a [ S5e[U[ 5(aUR5n[U5$)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) rUrrrr4r7rrHlistrs rCto_key_val_listrSsP" }%#udC011FGG%!!  ;rFc/n[U5H8nUSSUSSs=:XaS:XaO O[USS5nURU5 M: U$)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 Nrr")_parse_list_headerunquote_header_valueappend)rresultitems rCparse_list_headerrqsT.F"5) 8tBCy 'C ''Qr 3D d* MrFc0n[U5HKnSU;aSX'MURSS5up0USSUSSs=:XaS:XaO O[USS5nXU'MM U$)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)rr8r)rrrrs rCparse_dict_headerrsr,F"5) d?FL jja(  !9bc )c )(q5Et * MrFcU(aNUSUSs=:XaS:Xa;O U$USSnU(a USSS:wa"URSS5RS S5$U$) 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 rrrrNrTz\\\z\")r:)r is_filenames rCrrsd qU2Y-#- La eBQi61==.66ucB B LrFc\UVs0sHoRUR_M nnU$s snf)ztReturns a key/value dictionary from a CookieJar. :param cj: CookieJar object to extract cookies from. :rtype: dict )rr)cjcookie cookie_dicts rCdict_from_cookiejarrs.<>>2;; ,2K> ?s )c[X5$)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 rCadd_dict_to_cookiejarrs { //rFcZ[R"S[5 [R"S[R S9n[R"S[R S9n[R"S5nUR U5UR U5-UR U5-$)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=["\']*(.+?)["\'>])r[r\DeprecationWarningr;compiler=findall)content charset_re pragma_rexml_res rCget_encodings_from_contentrs  MM 1  @MJ IQSQUQUVI ZZ? @F 7#   G $ % .. ! "rFcPURS5nUSR5USSp20nSnUHrnUR5nU(dMUSpURS5n U S:wa*USU RU5nXiS-SRU5nXUR5'Mt X$4$) zReturns content type and parameters from given header :param header: string :return: tuple containing content type and dictionary of parameters r,rrNz"' Trr)r8stripfindlower) headertokens content_typeparams params_dictitems_to_stripparamkeyrindex_of_equalss rC_parse_content_type_headerrs\\# F!!9??,fQRj&KN  5#jjoO"$,_-33NC134::>J', $  $$rFcURS5nU(dg[U5upSU;aUSRS5$SU;agSU;agg) zqReturns encodings from given HTTP Header Dict. :param headers: dictionary to extract encoding from. :rtype: str z content-typeNcharsetz'"textz ISO-8859-1zapplication/jsonrM)rprr)headersrrs rCget_encoding_from_headersrs^;;~.L 5lCLFi &&u-- \)*rFc## URc UShvN g[R"UR5"SS9nUH!nURU5nU(dMUv M# URSSS9nU(aUv ggNm7f)zStream decodes an iterator.Nr:errorsrFT)final)encodingcodecsgetincrementaldecoderdecode)iteratorrdecoderchunkrvs rCstream_decode_response_unicoder.s~ zz**1::6iHG ^^E " 2H 4 (B   sBBAB&Bc## SnUbUS::a [U5nU[U5:aXX!-v X!- nU[U5:aMgg7f)z Iterate over slices of a string.rN)rO)string slice_lengthposs rC iter_slicesr?sP C|q06{ F 3-..  F s AAAcH[R"S[5 /n[UR5nU(a[ UR U5$[ UR USS9$![a URU5 N3f=f![a UR s$f=f)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.)r:r) r[r\rrrrr UnicodeErrorr TypeError)rtried_encodingsrs rCget_unicode_from_responserIs MM 1  O)3H -qyy(+ + 199hy99  -  " "8 , - yys#A'B'BBB! B!zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~cURS5n[S[U55HpnXSSn[U5S:XaNUR5(a9[ [ US55nU[;aXAUSS-X'M\SX3X'MgSX3X'Mr S RU5$![ a [SUS35ef=f) 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 %rrrTz"Invalid percent-escape sequence: ''N) r8rangerOisalnumchrr4r7r UNRESERVED_SETr)uripartsihcs rCunquote_unreservedr vs IIcNE 1c%j ! HQqM q6Q;199;; LAr ON"Qx|+uxj>58*~EH" 775> L #EaS!JKK Ls B,,CcdSnSn[[U5US9$![a [XS9s$f=f)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 rC requote_urirsG/0 5',3DEE 5S44 5s //c x[R"S[R"U55SnUR S5up4[R"S[R"[ [ U5555Sn[R"S[R"U55SU-nX%-Xe-:H$)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_atonr8dotted_netmaskr4)ipnetipaddrnetaddrbitsnetmasknetworks rCaddress_in_networkrs]]4!1!1"!5 6q 9FIIcNMGmmD&"2"2>#d)3L"MNqQGmmD&"2"27";I)r inet_ntoarpack)maskrs rCrrs7 b4i1, ,D   FKKd3 44rFcR[R"U5 g![a gf=f)z :rtype: bool FT)rrr6) string_ips rCis_ipv4_addressr&s.#  s  &&cURS5S:XaU[URS5S5nUS:dUS:ag[R "URS5S5 gg![a gf=f![ a gf=f)zJ Very simple check of the cidr format in no_proxy variable. :rtype: bool rrFr rT)countr4r8r7rrr6)string_networkr#s rC is_valid_cidrr*s C A% ~++C034D !8tby    ^11#6q9 :     s#A,(A<, A98A9< B B c#Z# USLnU(a2[RRU5nU[RU'Sv U(a)Wc[RU gU[RU'gg!U(a)Wc[RU fU[RU'ff=f7f)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)rWrorp)env_namer value_changed old_values rC set_environr/s%MJJNN8, $ 81  JJx('0 8$ = JJx('0 8$ s>B+A61B+62B((B+c*SnUnUcU"S5n[U5nURcgU(aSURSS5RS55n[ UR5(aKUHDn[ U5(a[ URU5(a gM2URU:XdMD g OpURnUR(aUS UR3- nUH;nURRU5(dURU5(dM; g [SU5 [UR5nSSS5 W(agg ![[R4a S nN/f=f!,(df  N9=f) z@ Returns whether we should bypass proxies or not. :rtype: bool c[RRU5=(d- [RRUR55$N)rWrorpupper)rs rC get_proxy(should_bypass_proxies..get_proxys-zz~~c"AbjjnnSYY[&AArFNno_proxyTc36# UHo(dM Uv M g7fr2rh)rir>s rCrk(should_bypass_proxies..sR%ITTDD%Is   r,:F)rrvr:r8r&r*rportendswithr/rrrgaierror) rxr6r4 no_proxy_argparsedproxy_iphost_with_portr>bypasss rCshould_bypass_proxiesrDs^B LZ( c]F SX%5%5c2%>%D%DS%IR 6?? + +$ **)&//8DD#E__0 %$__N{{Afkk]"33 ??++D11^5L5LT5R5R ! Z . !&//2F /  6??+ F  / .s*:F<E""F>FFF Fc6[XS9(a0$[5$)z5 Return a dict of environment proxies. :rtype: dict r6)rDr)rxr6s rCget_environ_proxiesrG4s S4 |rFc>U=(d 0n[U5nURc+URURURS55$URS-UR-URSUR-S/nSnUHnXQ;dM Xn U$ U$)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://)rrvrpscheme)rxproxiesurlparts proxy_keysproxy proxy_keys rC select_proxyrP@s mG}H {{8??GKK,>?? %("3"338$$$ J E  &E  L  LrFcDUbUO0nURn[U5RnURS5nUR 5nU(aO[ X5S9(dA[ X5S9nURXGRS55nU(aURXH5 U$)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)rxrrJrpcopyrDrG setdefault) requestrK trust_envrxrJr6 new_proxiesenviron_proxiesrNs rCresolve_proxiesrXZs!,g"G ++C c] ! !F{{:&H,,.K.sF-cE##F,?,?,FG   " "6 1 rFcUS[3$)zC Return a string representing the default user agent. :rtype: str rr)rs rCdefault_user_agentrZus V1[M ""rFc:[[5[SSS.5$)z1 :rtype: requests.structures.CaseInsensitiveDict z*/*z keep-alive)z User-AgentzAccept-EncodingAccept Connection)r"rZDEFAULT_ACCEPT_ENCODINGrhrFrCdefault_headersr_~s% ,.6&   rFc/nSnURU5nU(dU$[R"SU5HnURSS5upESURS50nURS5H9nURS5upURU5XhRU5'M; UR U5 M U$![a USpTNf=f![a  M8f=f) 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)rr;r8r7r) rlinks replace_charsvalrxrlinkrrs rCparse_header_linksres EM KK &E  xx& "))C+KCsyy*+\\#&E "[[- .3[[-GD=) * '  T!'$ L "r "  s#C6C CC C('C(asciirTcUSSnU[R[R4;agUSS[R:XagUSS[R[R 4;agUR [5nUS:Xag US:Xa"USSS2[:Xag US SS2[:Xag US:XaUSS[:Xag US S[:Xagg)z :rtype: str Nzutf-32rhz utf-8-sigrTzutf-16rrMz 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 rCguess_json_utfrvs"1XF &%%v':':;; bqzV__$ bqzf))6+>+>?? U#IA~A~ #A#;&  !$Q$<6 !A~ "1:  !":  rFc[U5nUup4pVpxn URn U (dXzpzU(aSRXJ/5n UcUnUcSn[X:USX45$)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) rx new_schemer@rJauthr>r<rrqueryfragmentrys rCprepend_scheme_if_neededr~sk s^F6<3F$d8 ]]F  4.) ~ | vtRA BBrFc[U5n[UR5[UR54nU$![[ 4a SnU$f=f)zoGiven a url with authentication components, extract them into a tuple of username,password. :rtype: (str,str) )rr)rrusernamepasswordr_r)rxr@r{s rCget_auth_from_urlrsU c]F('&//*BC K I & Ks*9AAc<Uup[XS5 [XS5 g)zVerifies 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)rrrs rCcheck_header_validityrs KD&*&+rFc  [U[5(a [UnO=[U[5(a [UnO[ SU<SUS[ U535eURU5(dUS:XaSOSn[ SUSU<35eg) Nz Header part (z) from z# must be of type str or bytes, not rrrzTInvalid leading whitespace, reserved character(s), or return character(s) in header z: )rUrr rr rtyper<)r header_partheader_validator_index validator header_kinds rCrrs+s##*+AB K ' '+,BC K?'&:115k1B0C E  ??; ' ' 6! ;f &&1]"[O E   (rFcz[U5upp4pVU(dX2p2URSS5Sn[XX4US45$)zK Given a url remove the fragment and the authentication part. :rtype: str rxrrr)rrsplitr)rxrJryrrrr|r}s rC urldefragauthr"sG 5=SM1FD%  ]]3 "2 &F vtUB? @@rFc[URSS5nUb3[UR[5(aU"UR5 g[ S5e![ a [ S5ef=f)z^Move file pointer back to its recorded starting position so it can be read again on redirect. rSNz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)rbodyrU_body_positionrr6r!)prepared_request body_seeks rC rewind_bodyr3sy(--vtrs #0$ :) ," c* ))HHWl489JKL <<7$L / B3J0 f&"J   6<@F202%22"$PM 05, 550 11*:z 46# "L  g  @C:  , &A"SrF