1jBUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZddlmZmZddlmZmZmZmZmZmZddlmZmZdd lmZdd lmZdd l m!Z!m"Z"m#Z#m$Z$dd l%m&Z'dd l(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5ddl(m6Z7ddl8m9Z9ddl:m;Z;mZ>ddl?m@Z@erddlAmBZBddlmCZCddlm%ZDddlEmFZFmGZGmHZHdZIdeJd<ejZLdeJd<dddZMdeJd<edZNed ZOd!jejd"ed#$d%ZRdeJd&<e jd'k(rd\d(ZTd\d)Z/ d]d*ZUd^d+ZV d_ d`d,ZWdad-ZXdbd.ZYejdcd/Z[ ddd0Z\eded1Z]e dfd2Z] dgd3Z]dhd4Z^did5Z_d_djd6Z`dkd7Zadld8Zbdmd9Zcdnd:Zddod;Ze dpd<Zfe dqd=Zge drd>Zg dsd?Zgdtd@ZheidAZjdeJdB<dudCZkdudDZldvdEZmdwdFZndxdGZodydHZpejdzdIZqd{dJZrd|d}dKZsd~dLZt d ddMZudddNZvddOZwddPZxdQjdRZzezdSzZ{ezdTzZ|ddUZ}ddVZ~ddWZddXZ ddYZddZZdd[Zy)z requests.utils ~~~~~~~~~~~~~~ This module provides utility functions that are used within Requests that are also useful for external consumption. ) annotationsN) OrderedDict) GeneratorIterable) TYPE_CHECKINGAnyFinalTypeVarcastoverload) make_headers parse_url)certs __version__)_HEADER_VALIDATORS_BYTE_HEADER_VALIDATORS_STRHEADER_VALIDATORSto_native_string) SupportsItems) Mappingbytes getproxiesgetproxies_environment integer_types is_urllib3_1 proxy_bypassproxy_bypass_environmentquotestrunquoteurlparse urlunparse)parse_http_listcookiejar_from_dict)FileModeWarning InvalidHeader InvalidURLUnrewindableBodyError)CaseInsensitiveDict) CookieJar)BufferedWriter)_types)PreparedRequestRequestResponse)z.netrc_netrcr NETRC_FILESr!DEFAULT_CA_BUNDLE_PATHPi)httphttps DEFAULT_PORTS_KT_VTz, z,\s*T)accept_encodingzaccept-encodingDEFAULT_ACCEPT_ENCODINGwin32c ddl} |j|jd}t |j |dd}|j |dd}|r|sy|jd}td|}|D]j}|dk(rd|vry |jdd }|jd d }|jd d}tj||tjsjy y#t$rYywxYw#t tf$rYywxYw)NrFz;Software\Microsoft\Windows\CurrentVersion\Internet Settings ProxyEnable ProxyOverride;z.Tz\.*z.*?)winreg ImportErrorOpenKeyHKEY_CURRENT_USERint QueryValueExOSError ValueErrorsplitfilterreplacerematchI)hostrFinternetSettings proxyEnable proxyOverridetests B/home/qreelify/venv/lib/python3.12/site-packages/requests/utils.pyproxy_bypass_registryrZcs%   %~~((N   f112BMRSTUVK"//0@/RSTUM- &++C0 t]3 ! Dy d?<<U+D<<U+D<<T*DxxdBDD) C  $  s#C(AC7( C43C47D D cBtr t|St|S)zReturn True, if the host should be bypassed. Checks proxy settings gathered from the environment, if specified, or the registry. )rrrZ)rTs rYrrs " #+D1 1(. .cFt|tr|jS|S)z/Returns an internal sequence dictionary update.) isinstance_SupportsItemsitems)ds rYdict_to_sequencerbs !^$wwy Hr\cd}d}ts!t|tr|jd}t |dr t |}n~t |dr |j }net |drY |j }tj|j}d|jvrtjdt t |drW |j#}t |d r:|8 |j%dd |j#}|j%|xsd|d}t)d||z S#tjt f$rYwxYw#t&$rd}Y?wxYw#t&$r||}YRwxYw) 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)rr^r!encodehasattrrfrgosfstatst_sizemodewarningswarnr(ioUnsupportedOperationAttributeErrorrirjrLmax)o total_lengthcurrent_positionrgs rY super_lenr{syL Jq#. HHW q)1v E uu H  XXZF88F+33L!&&  2$ q& % vvx q&!l&: %FF1aL#$668LFF+0q1 q,!11 22e''8    X%#$L%% 0 '#/  0s6*D8E(.7E8EE E%$E%( E87E8c`t|tr|jd}tjj d}||f}n dt D} ddlm}m}d}|D]D}tjj|}tjj|sB|}n|yt|} | j} | y ||j| } | r't| r| drdnd} | | xsd| d xsdfSyy#|t f$r|rYywxYw#t"t$f$rYywxYw) z;Returns the Requests tuple auth for a given url from netrc.rdNETRCNc3&K|] }d| yw)z~/N).0fs rY z!get_netrc_auth..s9Rs89sr)NetrcParseErrornetrcrrk)r^rdecodernenvirongetr4rrpath expanduserexistsr#hostnameauthenticatorsanyrLrGrv) url raise_errors netrc_filenetrc_locationsrr netrc_pathrlocrirTr3login_is rYget_netrc_authrs@ #ujj!(J%-9[9# 0   A''$$Q'Cww~~c"       c]{{ <  :&55d;F#f+%ay!aw-2vayB??&v )    (   s=A D#D+D>DDDDDD-,D-ct|dd}|rHt|ttfr1|ddk7r(|ddk7rtj j |Syyyy)z0Tries to guess the filename of the given object.nameNr<>)getattrr^r!rrnrbasename)objrs rYguess_filenamersX 3 %D 4#u.47c>d2hRUoww%%GV>.tr\cFtjj|r|Stjj|\}}|rytjj|sZtjj|\}}|sn5dj ||g}|r tjj|sZt j |s|St j|}||jvr|Stjj|jddd}tj|\}} tj||j|tj||S#tj|wxYw)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. /r)suffix)rnrrrNjoinzipfile is_zipfileZipFilenamelistsplitexttempfilemkstempwritereadclose)rarchivememberprefixzip_filerfdextracted_paths rYextract_zipped_pathsr"s;  ww~~d ggmmD)OGV "''..1''--0 66*+ "''..1   g & w'H X&&(( WW  fll3/3 4R 8F!))8B X]]6*+    s %F F c#JKtjtjj |\}} tj |d5}|dddtj ||y#1swY xYw#t$rtj|wxYww)z-Write a file to the disk in an atomic fashion)dirwbN) rrrnrdirnamefdopenrP BaseExceptionremove)filenametmp_descriptortmp_name tmp_handlers rY atomic_openrHs (//BGGOOH4MNNH YY~t ,     8X&    ( s47B#BA4B3B#4A=9B B  B#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)r^r!rboolrJrMrvalues rYfrom_key_val_listrUs6( }%#udC01FGG u r\cyNrrs rYto_key_val_listrrs*-r\cyrrrs rYrrts r\c|yt|ttttfr t dt|t rt|jSt|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) r^r!rrrJrMr_listr`rs rYrrxsP& }%#udC01FGG%(EKKM"" ;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 Nrr")_parse_list_headerunquote_header_valueappend)rresultitems rYparse_list_headerrsY.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 =Nrrr)rrNr)rrrrs rYparse_dict_headerrs},%'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 rrrrNrkz\\\z\")rP)r is_filenames rYrrsd qU2Y-#- La eBQi61==.66ucB B Lr\cX|Dcic]}|j|j}}|Scc}w)zReturns a key/value dictionary from a CookieJar. :param cj: CookieJar object to extract cookies from. :rtype: dict )rr)cjcookie cookie_dicts rYdict_from_cookiejarrs/<>>6;; ,>K> ?s'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 rYadd_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=["\']*(.+?)["\'>])rrrsDeprecationWarningrQcompilerSfindall)content charset_re pragma_rexml_res rYget_encodings_from_contentr s  MM 1  @MJ IQSQUQUVI ZZ? @F 7#   G $ % .. ! "r\cB|jd}|dj|dd}}i}d}|D]j}|j}|s|jdx}dk7s-|d|j|}||dzdj|} | ||j<l||fS)zReturns content type and parameters from given header. :param header: string :return: tuple containing content type and dictionary of parameters. rBrrNz"' rr)rNstripfindlower) headertokens content_typeparams params_dict strip_charsparamidxkeyrs rY_parse_content_type_headerr#s\\# F!!9??,fQRj&L)+KK-  UZZ_,c3+##K0C#')$**;7E',K $ -  $$r\c|jd}|syt|\}}d|vr|djdSd|vryd|vryy) z}Returns encodings from given HTTP Header Dict. :param headers: dictionary to extract encoding from. :rtype: str z content-typeNcharsetz'"textz ISO-8859-1zapplication/jsonrd)rrr)headersrrs rYget_encoding_from_headersr9s`;;~.L 5lCL&Fi &&u-- \)*r\c#K|j |Ed{ytj|jd}|D]}|j|}|s||jdd}|r|yy7ew)zStream decodes an iterator.NrPerrorsr\T)final)encodingcodecsgetincrementaldecoderr)iteratorrdecoderchunkrvs rYstream_decode_response_unicoder Rs  zz6f**1::6iHG ^^E " H 4 (B   sA<A:AA<"A<cyrrstring slice_lengths rY iter_slicesres$'r\cyrrrs rYrris"%r\c#Kd}||dkr t|}|t|kr||||z||z }|t|kryyw)z Iterate over slices of a string.rN)rf)rrposs rYrrmsY C|q06{ F S3-.. | F s AAAc`tjdt|jyg}t |j }|r t |j|S t |j|xsddS#t$r|j|Y9wxYw#t$r|jcYSwxYw)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.)NrdrPr) rrrsrrrrr! UnicodeErrorr TypeError)rtried_encodingsrs rYget_unicode_from_responserys MM 1   yy!#O)3H -qyy(+ + 199h1')DD  -  " "8 , - yys$A5B5BBB-,B-zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~UNRESERVED_SETc|jd}tdt|D]l}||dd}t|dk(rI|jr9 t t |d}|tvr|||ddz||<Vd||||<bd||||<nd j|S#t $rtd|dwxYw) 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 %rrrkz"Invalid percent-escape sequence: ''Nr) rNrangerfisalnumchrrJrMr*rr)uripartsihcs rYunquote_unreservedr's IIcNE 1c%j ! & !HQqM q6Q;199; LAr ON"uQx|+auQxj>a58*~E!H & 775> L #EaS!JKK Ls B''Ccpd}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 r'r*)r"safe_with_percentsafe_without_percents rY requote_urir,sJ/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_atonrNdotted_netmaskrJ)ipnetipaddrnetaddrbitsnetmasknetworks rYaddress_in_networkr:s]]4!1!1"!5 6q 9FIIcNMGTmmD&"2"2>#d)3L"MNqQGmmD&"2"27";I)r0 inet_ntoar.pack)maskr7s rYr2r2s7 b4i1, ,D   FKKd3 44r\cN tj|y#t$rYywxYw)z :rtype: bool FT)r0r1rL) string_ips rYis_ipv4_addressrBs.#  s  $$c |jddk(rR t|jdd}|dks|dkDry t j |jddyy#t$rYywxYw#t $rYywxYw)zV Very simple check of the cidr format in no_proxy variable. :rtype: bool rrFr<rT)countrJrNrMr0r1rL)string_networkr?s rY is_valid_cidrrFs C A% ~++C034D !8tby    ^11#6q9 :     s"A('A7( A43A47 BBc#<K|du}d}|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)rnrr)env_namer value_changed old_values rY set_environrKs%M IJJNN8, $ 81  JJx('0 8$ = JJx('0 8$ s;BA-+B-,BBcd d}|}||d}t|}|j}|y|rd|jddjdD}t |r)|D]#}t |rt ||sy||k(s#ynm|}|jr|d |jz }|D]H} | jd } || k(s|| k(ryd | z} |j| s|j| sHytd|5 t|} ddd ryy #ttjf$rd } Y)wxYw#1swY.xYw) zL Returns whether we should bypass proxies or not. :rtype: bool ctjj|xs-tjj|jSr)rnrrupper)rs rY get_proxyz(should_bypass_proxies..get_proxy3s-zz~~c"AbjjnnSYY[&AAr\Nno_proxyTc3&K|] }|s| ywrr)rrTs rYrz(should_bypass_proxies..EsX4SW$Xs r,:rCF)rr!return str | None)r#rrPrNrBrFr:portlstripendswithrKrrr0gaierror) rrPrO no_proxy_argparsedrno_proxy_hostsproxy_iphost_with_portrTbypasss rYshould_bypass_proxiesra*snB LZ( c]FHY8+;+;C+D+J+J3+OX 8 $*  *)(H=#)  &N{{Afkk]"33& {{3't#~'=Tz$$T*n.E.Ed.K   Z . !(+F   6??+ F s*D< DD96D<8D99D<<Ec4t||riStS)zA Return a dict of environment proxies. :rtype: dict rP)rar)rrPs rYget_environ_proxiesrdis 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#rrscheme)rproxiesurlparts proxy_keysproxy proxy_keys rY select_proxyrmus mG}H {{8??GKK,>?? %("3"338$$$ J E  I&E  L  Lr\cT||ni}tt|j}t|j}|j d}|j }|rOt||sBt||}|j ||j d}|r|j|||S)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 rPrcrf) r r!rr#rgrcopyrard setdefault) requestrh trust_envrrgrP new_proxiesenviron_proxiesrks rYresolve_proxiesrus!,g"G sGKK C c] ! !F{{:&H,,.K.sXF-cHE##FO,?,?,FG   " "65 1 r\c|dtS)zO Return a string representing the default user agent. :rtype: str rr)rs rYdefault_user_agentrws V1[M ""r\c:tttdddS)z9 :rtype: requests.structures.CaseInsensitiveDict z*/*z keep-alive)z User-AgentzAccept-EncodingAccept Connection)r,rwr=rr\rYdefault_headersr{s% ,.6&   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)rrQrNrMr) rlinks replace_charsvalrrlinkrrs rYparse_header_linksrs#%EM KK &E  xx& "))C+KC!&syy':;\\#& HE "[[- U.3[[-GD=) *  H  T!$ L "rC "  s#B?1C? CC CCasciirkc|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-32rz utf-8-sigrkzutf-16rrdz 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_BErD_null_null2_null3)datasample nullcounts rYguess_json_utfrs"1XF &%%v':':;; bqzV__$ bqzf))6+>+>?? U#IA~A~ #A#;&  !$Q$<6 !A~ "1:  !":  r\ct|}|\}}}}}}} |j} | s|| }} |r#tt| } dj || g} ||}|d}t || |d|| 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)rnetlocr r!rr$) r new_schemer\rgauth_host_portrqueryfragmentrs rYprepend_scheme_if_neededrs s^F8>5FD%eX ]]F V c6"4.) ~ | vvtRA BBr\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#r"usernamepasswordrvr)rr\rs rYget_auth_from_urlr.sU c]F('&//*BC K I & Ks*9A AcB|\}}t||dt||dy)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 rYcheck_header_validityr?s% KD%&$*&%+r\c t|tr t|}n7t|tr t|}nt d|d|dt ||j|s|dk(rdnd}t d|d|y) 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: )r^r!rrrr)typerR)r header_partheader_validator_index validator header_kinds rYrrJs +s#*+AB K '+,BC K?'&:115k1B0C E  ??; ' 6! ;f &&1]"[O E   (r\c~t|\}}}}}}|s||}}|jddd}t|||||dfS)zW Given a url remove the fragment and the authentication part. :rtype: str rrrr)r#rsplitr$)rrgrrrr _fragments rY urldefragauthrbsU 6>c]2FFD&% V ]]3 "2 &F vvtVUB? @@r\ct|jdd}|.t|jtr ||jyt d#t $r t dwxYw)zfMove file pointer back to its recorded starting position so it can be read again on redirect. rjNz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)rbodyr^_body_positionrrLr+)prepared_request body_seeks rY rewind_bodyrssu(--vtrs#  #/1$ 4:( ,(!::) U)*ekkm+!#S1 u1 en en"& BHHWl489JKL" <<7$L / =  D3P+01 1 #'1 1 h&#L    ?: - -  A     H!@@F202%,2"*'& ' '!+'!' ' % %)%% %   '1 ' &T"M 05, 550 11,<~ : & " ># "L  g  @C<", +      0A"Sr\