|gN ddlZddlZddlZddlZddlmZmZmZddlm Z ddl m Z m Z ddl mZddlmZmZmZmZmZmZmZmZddlmZmZmZmZmZmZddlZddl m!Z!m"Z"m#Z#dd l$m%Z&d d l'm(Z(m)Z)d d d d ddZ*e+eZ,e+eZ-e+dZ.e/Z0ejbdejdZ3ee4e5e6fZ7ee7dfZ8ede4ddfZ9edZ:ejvdk\rddlmGddedZ?de:d e:fd!Z@d"d#d eAe4fd$ZBe@Gd%d&ZCd'ee4dfd(e4d ee4dffd)ZDd*ZEe eEd+e4d e4fd,aFe eEd-e4d e4fd.aGe eEd/e4d eHe4e5ffd0aIe eEd-e4d dfd1aJe@d:d2ZKe@d e=fd3ZLe@eEeEeEeEd4d5ee5dfd6ee5dfd7ee5dfd8ee5dfd df d9ZMy);N)IterableMappingSequence)suppress) _CacheInfo lru_cache) ip_address) TYPE_CHECKINGAny SupportsIntTuple TypedDictTypeVarUnionoverload) SplitResult parse_qslquoteurlsplit uses_netloc uses_relative) MultiDictMultiDictProxyistr)under_cached_property)_Quoter _UnquoterPi)httphttpswswssftpa< # any character not in the unreserved or sub-delims sets, plus % # (validated with the additional check for pct-encoded sequences below) [^a-z0-9\-._~!$&'()*+,;=%] | # % only allowed if it is part of a pct-encoded # sequence of 2 hex digits. %(?![0-9a-f]{2}) zSequence[SimpleQuery]zMapping[str, QueryVariable]z#Sequence[Tuple[str, QueryVariable]]_T) )Selfc:eZdZUdZeed<eed<eed<eed<y) CacheInfozHost encoding cache. idna_encode idna_decoder host_validateN)__name__ __module__ __qualname____doc__r__annotations__F/var/www/html/pythonbot/venv/lib/python3.12/site-packages/yarl/_url.pyr+r+Isr5r+c@eZdZUeed<eed<eed<eed<eed<y)_SplitResultDictschemenetlocpathqueryfragmentN)r/r0r1strr3r4r5r6r8r8Rs K K I JMr5r8F)totalceZdZUded<eed<eed<eed<eedfed<eed<eedfed <eedfed <eedfed <eedfed <eedfed <eedfed<eedfed<eedfed<eedfed<eed<eed<ee eefed<ded<eed<eed<eed<eed<eed<eed<e edfed<e edfed<ded <eed!<eed"<eed#<eed$<e edfed%<e edfed&<y)'_InternalURLCacheURL_originabsoluter9 raw_authorityN _default_port authorityraw_useruser raw_passwordpasswordraw_hosthosthost_subcomponentport explicit_portraw_pathr; _parsed_queryMultiDictProxy[str]r<raw_query_string query_stringpath_qs raw_path_qs raw_fragmentr=. raw_partspartsparentraw_namename raw_suffixsuffix raw_suffixessuffixes) r/r0r1r3boolr>rintlisttupler4r5r6rArA[sH NN Kd##NCI T T ""CICI T S$Y'' T d##M Ic3h((   LMS#X c? MM IO KS/!CHor5rAobjreturncd|_|S)Nyarl)r0)rfs r6rewrite_modulerjsCN Jr5segments Sequence[str]cg}|D]G}|dk(r)tt5|jddd1|dk7s7|j|I|r|ddvr|jd|S#1swYoxYw)z1Drop '.' and '..' from a sequence of str segments..N.rorn)r IndexErrorpopappend)rk resolved_pathsegs r6_normalize_path_segmentsrxs "M& $;*% $!!# $ $ CZ   %&HRLK/ R  $ $s A++A4 cb eZdZUdZedZeZedddZeddZedd d d Z edd d Z edd d Z eddZ edZ eZedZeddZed Zeed< dddddeeedfdedeedfdefdZedddddddddddd ded ed!eedfd"eedfd#ed$eedfd%ed&eedfd'ed(ededdfd)Zededdfd*Zd+Zdefd,Z e!ded-ed.ed&ed(edef d/Z"defd0Z#de$fd1Z%d2e&defd3Z'defd4Z(d2e&defd5Z)d2e&defd6Z*d2e&defd7Z+d2e&defd8Z,d9eddfd:Z-d&eddfd;Z.defd<Z/de0efd=Z1d>Z2dd?Z3defd@Z4defdAZ5ddBZ6e7ddCZ8ddDZ9e7defdEZ:e7defdFZ;e7defdGZe7deedffdJZ?e7deedffdKZ@e7deedffdLZAe7deedffdMZBe7deedffdNZCe7deedffdOZDe7deedffdPZEe7deedffdQZFe7deedffdRZGe7defdSZHe7defdTZIe7defdUZJe7deKe0eeffdVZLe7ddWZMe7defdXZNe7defdYZOe7defdZZPe7defd[ZQe7defd\ZRe7defd]ZSe7de0ed^ffd_ZTe7de0ed^ffd`ZUe7ddaZVe7defdbZWe7defdcZXe7defddZYe7defdeZZe7de0ed^ffdfZ[e7de0ed^ffdgZ\e!ddhZ]ddidjdeddfdkZ^ed%edefdlZ_ee`d#ede0eeeedfeeeffdmZaed#ednedefdoZbee` dd!eedfd"eedfd#eedfd$eedfdpedef dqZcee`d-ede0eedfeedfeedfeedfffdrZddeddfdsZed!eedfddfdtZfd"eedfddfduZgd#eddfdvZhd$eedfddfdwZiddxd%ededdfdyZjdzeke0eeelfemfdefd{Zne!d|emdefd}Zodzeke0eeelfefdefd~ZpdeqdeqdeedffdZresd&eddfdZtesdemddfdZtdeqdeqddfdZtesd&eddfdZuesdemddfdZudeqdeqddfdZuesd&eddfdZvesdemddfdZvdeqdeqddfdZvdeddfdZwd(eedfddfdZxd9eddfdZydeddfdZzddZ{ddxd2ededdfdZ|defdZ}y)rB)_cache_valF)requotez@:z/+)safe protectedr|)r}r~z?/:@z=+&;T)r}r~qsr|)r}r~r)r}rr|)r}r|)r}+)unsafez/%)ignorer)rr{rrN)encodedstrictvalrrrgc|tjdt|tur t |}n]t||ur|St|t ur |s;t dt|trt t|}n tdi}|s|\}}}}} |sd} nd|vsd|vsd|vr|j|\} } } } ndx} x} } |} | |tvrd|d }t |d} |j| d } d| vr| d d n| |d<| |d<| | | | }d|d<d|d<nH| r|j| n| }| r|j| n| }|j||| | }||d<||d<|r@|j|}|r-d|vr|j|}|ddk7r|j!|r|j#|n|}| r|j%| n| } ||d<||d<| |d<|j&|k7s-|j(|k7s|j*|k7s|j,| k7rt ||||| }t.j1|}||_||_|S)Nzstrict parameter is ignoredz$Cannot apply decoding to SplitResultz#Constructor parameter should be strrr:@[z9Invalid URL: host is required for absolute urls with the  schemeF validate_hostrrprLrPrHrJror/r9rTrX)warningswarntyper>rr ValueError isinstance TypeError _split_netlocSCHEME_REQUIRES_HOST _encode_host _REQUOTER _make_netloc_PATH_REQUOTER_normalize_path%_raise_for_authority_missing_abs_path_QUERY_REQUOTER_FRAGMENT_REQUOTERr:r;r<r=object__new__r{rz)clsrrrcacher9r:r;r<r=rMusernamerKrOmsgrHrJselfs r6rz URL.__new__s   MM7 8 9 3-C #Y# J #Y+ % !GHH S !3s8$CAB B#%47 1FFD%&=C6MSF]585F5Fv5N2Hhd155H5x$!D<!5566F3==#:HL --h dDQF(0E*%,8E.)))$/d{"2248Aw#~AAC27C''.UE;Cs--h7H$E(O(-E$ %$,E. !  f$88t#99%<<8+!&&$xH~~c"   r5) r9rGrIrKrMrOr;r<rUr=rr9rGrIrKrMrOr;r<rUr=c |r|s|s|s|r td|t|ts td|r |s td|r | r td| |||| | td| rH|r|} n:|r=||tj |k(rdn|}||||} n|j ||||} nd} nd} |r.|j|\}}} }| r|j| d nd} n|r|j|d } nd} | <||tj |k(rdn|}|||| } n|j ||| |d } |r|j|n|}|r/ r-d |vr|j|}|d d k7r|j| r|j| n| } | r|j| n| } |jt| || | }|r|j!|S|S)zCreates and returns a new URLz@Can't mix "authority" with "user", "password", "host" or "port".NzThe port is required to be int.z/Can't build URL with "port" but without "host".z6Only one of "query" or "query_string" should be passedz}NoneType is illegal for "scheme", "authority", "host", "path", "query_string", and "fragment" args, use empty string instead.rrFrTrorr)rrrcr DEFAULT_PORTSgetrrr _PATH_QUOTERrr _QUERY_QUOTER_FRAGMENT_QUOTER _from_valr with_query)rr9rGrIrKrMrOr;r<rUr=rr:_hosturls r6buildz URL.buildPsA$ $(ddS   JtS$9=> > OP P \UV V N ||#Q  "##'=+<+==?4@!!,/\ :Bs++H5xHmmKlHUV >>%( ( r5cLtj|}||_i|_|S)z$Create a new URL from a SplitResult.)rrr{rz)rrrs r6rz URL._from_vals%~~c"   r5c td|d)NzInheriting a class z from URL is forbidden)r)rs r6__init_subclass__zURL.__init_subclass__s-cW4JKLLr5cZ|j}|\}}}}}|js&|jr|js |jrd}|j x}C||j k(r4|j}|j|j|j|d}|j|||||S)Nr) r{r;r:r<r=rPrFrNrrHrJ_unsplit_result) rrr9r:r;r<r=rOrMs r6__str__z URL.__str__sii03-eXxxCJJCIID&& &D 3@R@R8R))D&&t}}d6G6GtTF##FFD%JJr5r:rc|s|r|tvs|dddk(r"|r|dddk7r d|xsdd|}n d|xsd|}|r|d|}|r|d|}|r|d |S|S) z(Unsplit a URL without any normalization.Nz//rrrrr?#)USES_AUTHORITY)r9r:rr<r=s r6rzURL._unsplit_results f>!9c"1gos2Aw#~6rs r6__repr__z URL.__repr__s$..))*"SYKr::r5c6t|jdS)Nascii)r>encoders r6 __bytes__z URL.__bytes__s4y((r5otherct|turtS|j}|js|j r|j d}|j}|js|j r|j d}||k(S)Nrr;)rrBNotImplementedr{r;r:_replace)rrval1val2s r6__eq__z URL.__eq__sj ;c !! !yyyyT[[==c=*DzzyyT[[==c=*Dt|r5c|jjd}|P|j}|js|jr|j d}t |x}|jd<|S)Nhashrr)rzrr{r;r:rr)rretrs r6__hash__z URL.__hash__s[kkoof% ;))C88 lll,(,S 1C$++f% r5cbt|turtS|j|jkSNrrBrr{rrs r6__le__z URL.__le__' ;c !! !yyEJJ&&r5cbt|turtS|j|jkSrrrs r6__lt__z URL.__lt__' ;c !! !yy5::%%r5cbt|turtS|j|jk\Srrrs r6__ge__z URL.__ge__rr5cbt|turtS|j|jkDSrrrs r6__gt__z URL.__gt__rr5r]cdt|tstS|jt|fSr)rr>r _make_childrr]s r6 __truediv__zURL.__truediv__s)$$! !T --r5c$|j|Sr) update_queryrr<s r6__mod__z URL.__mod__s  ''r5c|j}t|jxs(|jxs|jxs |j Sr)r{rbr:r;r<r=rrs r6__bool__z URL.__bool__s5iiCJJG#((GciiG3<<HHr5c|jfSr)r{rs r6 __getstate__zURL.__getstate__ s |r5c~|d(t|dtr|dd|_i|_y|^|_}i|_y)Nrrr{)rdictr{rz)rstateunuseds r6 __setstate__zURL.__setstate__sG 8  58T :a(DI "' DI r5c|j}|j|jj\|d<|d<|d<|d<y)z"Cache the netloc parts of the URL.rHrJrLrPN)rzrr{r:)rrs r6 _cache_netloczURL._cache_netlocsJ    tyy// 0  *  . ! *  / "r5c|jS)zA check for absolute URLs. Return True for absolute ones (having scheme or starting with //), False otherwise. Is is preferred to call the .absolute property instead as it is cached. )rDrs r6 is_absolutezURL.is_absolute!s}}r5cn|jx}|jjdk7S||jk(S)zA check for default port. Return True if port is default for specified scheme, e.g. 'http://python.org' or 'http://python.org:80', False otherwise. Return False for relative URLs. rr)rPr{r:rF)rexplicits r6is_default_portzURL.is_default_port,s=** *H 399##r) )4----r5c|jS)z}Return an URL with scheme, host and port parts only. user, password, path, query and fragment are removed. )rCrs r6originz URL.origin=s||r5c\|j}|js td|js tdd|jvr|j ddd}n?|j }|j dd||j}|j |ddd}|j|S)z|Return an URL with scheme, host and port parts only. user, password, path, query and fragment are removed. URL should be absolutezURL should have schemerrrr;r<r=N)r:r;r<r=) r{r:rr9rrNrrPr)rvr encoded_hostr:s r6rCz URL._originFs IIxx56 6xx56 6 ahh **"B***r5cB|j}|y|j|S)zMDecoded password part of URL. None if password is missing. N)rJr)rrJs r6rKz URL.passwords'((  ~~l++r5c@|j|jdS)zEncoded host part of URL. None for relative URLs. When working with IPv6 addresses, use the `host_subcomponent` property instead as it will return the host subcomponent with brackets. rLrrs r6rLz URL.raw_hosts {{:&&r5cl|jx}y|r|djsd|vr|St|S)zDDecoded host part of URL. None for relative URLs. Nrpr)rLisdigit _idna_decoderraws r6rMzURL.hosts<== C ) 3r7??$s JC  r5c8|jx}yd|vrd|dS|S)aReturn the host subcomponent part of URL. None for relative URLs. https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2 `IP-literal = "[" ( IPv6address / IPvFuture ) "]"` Examples: - `http://example.com:8080` -> `example.com` - `http://example.com:80` -> `example.com` - `https://127.0.0.1:8443` -> `127.0.0.1` - `https://[::1]:8443` -> `[::1]` - `http://[::1]` -> `[::1]` Nrr])rLrs r6rNzURL.host_subcomponents/$== C ) CZ3%qz0S0r5c6|jxs |jS)zPort part of URL, with scheme-based fallback. None for relative URLs or URLs without explicit port and scheme without default port substitution. )rPrFrs r6rOzURL.ports!!7T%7%77r5c@|j|jdS)zyPort part of URL, without scheme-based fallback. None for relative URLs or URLs without explicit port. rPrrs r6rPzURL.explicit_ports {{?++r5cf|jj}|s|jjrd}|S)zNEncoded path of URL. / for absolute URLs without path part. r)r{r;r:)rrs r6rQz URL.raw_paths*iinntyy''C r5c8|j|jS)zNDecoded path of URL. / for absolute URLs without path part. )_PATH_UNQUOTERrQrs r6r;zURL.paths""4==11r5c8|j|jS)z{Decoded path of URL. / for absolute URLs without path part. / (%2F) and % (%25) are not decoded )_PATH_SAFE_UNQUOTERrQrs r6 path_safez URL.path_safes'' 66r5cDt|jjdS)zParse query part of URL.Tkeep_blank_values)rr{r<rs r6rRzURL._parsed_query%sDAAr5c>tt|jS)zA MultiDictProxy representing parsed query parameters in decoded representation. Empty value if URL has no query part. )rrrRrs r6r<z URL.query*si(:(:;<zURL.parts..{sEdT^^D)E)rerYrs`r6rZz URL.partstsEdnnEEEr5c|j}|r|dk(rZ|jjs|jjr,|j |jj ddS|S|j d}|jj dj|dddd}|j |S)z]A new URL with last part of path removed and cleaned up query and fragment. rrr)r<r=Nrpr)rQr{r=r<rrr'join)rr;rZrs r6r[z URL.parent}s }}ts{yy!!TYY__~~dii&8&8rB&8&OPPK 3ii  chhuSbz&:"r R~~c""r5cj|j}|jjr |dd}|sy|dS|dS)zThe last part of raw_parts.rNrrrp)rYr{r:)rrZs r6r\z URL.raw_names? 99  !"IERy 9 r5c8|j|jS)zThe last part of parts.)rr\rs r6r]zURL.names~~dmm,,r5c||j}|jd}d|cxkrt|dz krny||dSy)Nrorrrr)r\rfindlen)rr]is r6r^zURL.raw_suffixsB}} JJsO q 3t9q= 8Or5c8|j|jSr)rr^rs r6r_z URL.suffixs~~doo..r5c|j}|jdry|jd}td|j dddDS)Nror4c3&K|] }d|z yw)roNr4)r+r_s r6r-z#URL.raw_suffixes..sDfS6\Dsr)r\endswithlstriprer'rs r6r`zURL.raw_suffixessH}} == {{3D 30CDDDr5c@tfdjDS)Nc3@K|]}j|ywrr*)r+r_rs r6r-zURL.suffixes..sLT^^F+Lr.)rer`rs`r6raz URL.suffixessL$:K:KLLLr5cd}t|)zFRaise when he path in URL with authority starts lacks a leading slash.zCPath in a URL with authority should start with a slash ('/') if set)r)rs r6rz)URL._raise_for_authority_missing_abs_pathsTor5pathsrlcg}d}tt|D]~\}}|dk(}|r|ddk(rtd|d|r|n|j|}|d|vz}|j d}|j t | xr|ddk(} ||| dz }|j |jjr<|jjj dx} r| d dk(rd nd} g| d| |}|jjr|r t|n|}|r |ddk7rdg|}dj|} |j|jj| dd S) z add paths to self._val.path, accounting for absolute vs relative paths, keep existing, but do not create new, empty segments FrrzAppending path z! starting from slash is forbiddenrorrNrpr) enumeratereversedrrr'reversercr{r;r:rxr0rr) rr?rparsedneeds_normalizeidxr;lastrksegment_slice_startold_path_segmentsold_path_cutoffnew_paths r6rzURL._make_childs  %"8E?3 5IC!8DQ3 %dX-NO#4(9(9$(?D sd{ *Ozz#H    "%$h&D8A;"3D"E  h234 4F 5  99>>DIINN4H4H4MM0M$5b$9R$?bTOD()9/:DVDF 99  9H-f5fF&)r/v88F#~~dii00hbSU0VWWr5cd}|r|ddk(rd}|dd}|jd}|djt|zS)Nrrrrr)r'r0rx)rr;prefixrks r6rzURL._normalize_pathsO DGsNF8D::c?!9(!CDDDr5c|j}|j}|r:|djsd|vr#d|vrd||g|jdSd|||ddfSd||dddfS)aEParse host into parts Returns a tuple of: - True if the host looks like an IP address, False otherwise. - Lowercased host - True if the host is ASCII-only, False otherwise. - Raw IP address - Separator between IP address and zone - Zone part of the IP address rpr%TrrF)lowerisasciir  partition)rrM lower_hostis_asciis r6 _parse_hostzURL._parse_hosts|ZZ\ <<> T"X%%'3$;d{ZGDNN34GGGXtR; ;j(BB66r5rc|j|\}}}}}}|r0 t|\}} | dk(r|r d|d|dSd|dS|r|d|S|S|r|r t||St |S#t$rY'wxYw)zEncode host part of URL.rrOr)rU_ip_compressed_versionr_host_validate _idna_encode) rrMr looks_like_iprSrTraw_ipsepzoneversions r6rzURL._encode_host sBEQUAV> z8VS$ & 9 6v > g a<14QtfAdV1-EAdV1+E+.$q'8D8 z* J'')  sA'' A32A3rc|y|}||d|}|||S|3|sd}n|r|j|}|r|j|}|d|}n|r|r|j|}|r|d|S|S)zMake netloc from parts. The user and password are encoded if encode is True. The host must already be encoded with _encode_host. rrrr)_QUOTER)rrIrKrMrOrrs r6rzURL._make_netloc8s <  E4&/C rrPr{r:rrrr)rr9 lower_schemers r6 with_schemezURL.with_scheme~s}&#&12 2||~ yyL4H$H))5g? S/ !~~dii00 0EFFr5cb|j}|d}n9t|tr|j|}|j}n t d|j s td|jxsd}|j||||j}|j|j|S)zReturn a new URL with user replaced. Autoencode user if needed. Clear user/password if user is None. NzInvalid user typez1user replacement is not allowed for relative URLsrrr:) r{rr>rarJrr:rrNrrPrr)rrIrrKrr:s r6 with_userz URL.with_usersii <H c "<<%D((H/0 0zzPQ Q--3 ""4<ASAST~~cll&l9::r5cn|n-t|tr|j|}n td|jj s t d|jxsd}|j}|j|j|||}|j|jj|S)zReturn a new URL with password replaced. Autoencode password if needed. Clear password if argument is None. zInvalid password typez5password replacement is not allowed for relative URLsrrrq) rr>rarr{r:rrNrPrrHrr)rrKrrOr:s r6 with_passwordzURL.with_passwords    # &||H-H34 4yyTU U--3 !!""4==(L$O~~dii000?@@r5cpt|ts td|j}|js t d|s t d|r|j |dnd}|j}|j|j|j||}|j|j|S)zReturn a new URL with host replaced. Autoencode host if needed. Changing host for relative URLs is not allowed, use .join() instead. zInvalid host typez1host replacement is not allowed for relative URLszhost removing is not allowedTrrrrq) rr>rr{r:rrrPrrHrJrr)rrMrrrOr:s r6 with_hostz URL.with_hosts$$/0 0iizzPQ Q;< |j|}|jjrd|vr|j|n|}t |dkDr |ddk7rd|z}|j |jj |ddS)z$Return a new URL with path replaced.rorrrrr)rr{r:rr5rr)rr;rs r6 with_pathz URL.with_paths}$$T*Dyy58D[t++D1d t9q=T!W^:D~~dii00d"r0RSSr5itemsc >|j}|Dcgc]k\}}t|turt|tt fr|n|fD]7}||d|t|tur|n|j |9m}}}}dj|Scc}}}w)zReturn a query string from a sequence of (key, value) pairs. value is a single value or a sequence of values for the key The sequence of values must be a list or tuple. =&)_QUERY_PART_QUOTERrr>rrdre _query_varr0)rr|quoterkrrpairss r6%_get_str_query_from_sequence_iterablez)URL._get_str_query_from_sequence_iterables((   39C'JsT5M,JV  ayk6tAw#~!4??1;MNO P P  xx sA0Brct|}t|trtrt |tsJ|S|t ur t|St|t rltrt |t sJtj|r tdtj|r tdtt |S|tur$t |trtt |Stdj||)Nzfloat('inf') is not supportedzfloat('nan') is not supportedzMInvalid variable type: value should be str, int or float, got {!r} of type {})r issubclassr>r rrcfloatmathisinfrisnanrbr rformat)rrs r6rzURL._query_vars1g c3 !!S)))H #:q6M c5 !!!U+++zz!} !@AAzz!} !@AAuQx= d?z#{;s1v;  3  r5c |j}|Dcgc]:\}}||d|t|tur|n|j|<}}}dj |Scc}}w)aReturn a query string from an iterable. The iterable must contain (key, value) pairs. The values are not allowed to be sequences, only single values are allowed. For sequences, use `_get_str_query_from_sequence_iterable`. r~r)rrr>rr0)rr|rrrrs r6_get_str_query_from_iterablez URL._get_str_query_from_iterablesq((  1ayk6tAw#~!4??1;MNO P  xx  s?A%argskwargsc|rt|dkDr td|}nt|dk(r|d}n td|yt|tr|j |j St|t r|j|St|tttfr tdt|tr|j|Std)Nrz7Either kwargs or single query parameter must be presentrzAInvalid query type: bytes, bytearray and memoryview are forbiddenzRInvalid query type: only str, mapping or sequence of (key, value) pairs is allowed)r5rrrrr|r>rbytes bytearray memoryviewrrr)rrrr<s r6_get_str_queryzURL._get_str_query.s 4y1} ME Y!^GEVW W = eW %==ekkmL L eS !%%e, , eeY ; <S  eX & 44U; ; 8  r5cyrr4rs r6rzURL.with_queryQs14r5c yrr4rrs r6rzURL.with_queryTsB ~~dii00y0ABBr5cyrr4rs r6 extend_queryzURL.extend_queryi36r5c yrr4rs r6rzURL.extend_queryl>Ar5c|j|i|}|s|S|jjx}r|ddk(r||z }n |d|z }n|}|j|jj |S)a&Return a new URL with query part combined with the existing. This method will not remove existing query parameters. Example: >>> url = URL('http://example.com/?a=1&b=2') >>> url.extend_query(a=3, c=4) URL('http://example.com/?a=1&b=2&a=3&c=4') rprr)rr{r<rr)rrrnew_query_stringrs r6rzURL.extend_queryos/4..??K  '9 '}#-- q!1 233 (I~~dii00y0ABBr5cyrr4rs r6rzURL.update_queryrr5c yrr4rs r6rzURL.update_queryrr5cv|j|i|}|+|j|jjdSt |j }|j t|d|j|j}|j|jj|S)aReturn a new URL with query part updated. This method will overwrite existing query parameters. Example: >>> url = URL('http://example.com/?a=1&b=2') >>> url.update_query(a=3, c=4) URL('http://example.com/?a=3&b=2&c=4') rrrTr) rrr{rrrRupdaterrr|)rrrsr<new_strs r6rzURL.update_querys D   0 0 9>>$))"4"42"4">? ?$,,- YqD9:33EKKMB~~dii00w0?@@r5 query_paramsct||jjzs|S|jt fd|jj DS)z4Remove some keys from query part and return new URL.c34K|]\}}|vr||fywrr4)r+r]valueparams_to_removes r6r-z+URL.without_query_params..s*D%//u s)setr<keysrrer|)rrrs @r6without_query_paramszURL.without_query_paramssY|,tzz/@@K #'::#3#3#5   r5c|d}n,t|ts td|j|}|jj |k(r|S|j |jj|S)zReturn a new URL with fragment replaced. Autoencode fragment if needed. Clear fragment to default if None is passed. rrzInvalid fragment type)r=)rr>rrr{r=rr)rr=rXs r6 with_fragmentzURL.with_fragmentsm  LHc*34 400:L 99   -K~~dii00,0GHHr5ct|ts tdd|vr td|j |}|dvr tdt |j }|jjr+t|dk(r|j|n||d<d|d <n||d<|d dk(rd|d <|j|jjdj|dd S) zReturn a new URL with name (last part of path) replaced. Query and fragment parts are cleaned up. Name is encoded if needed. zInvalid name typerzSlash in name is not allowedrqz. and .. values are forbiddenrrprrrr)rr>rrrrdrYr{r:r5rurrr0)rr]rZs r6 with_namez URL.with_names$$/0 0 $;;< <  & ; <= =T^^$ 99  5zQ T" b E!HE"IQx3a~~ II  CHHUO2  K  r5r_ct|ts td|r|ddk(r|dk(rtd||j}|st|d|j }|s||zn|dt | |z}|j|S)zReturn a new URL with suffix (file extension of name) replaced. Query and fragment parts are cleaned up. suffix is encoded if needed. zInvalid suffix typerrozInvalid suffix z has an empty nameN)rr>rrr\r^r5r)rr_r] old_suffixs r6 with_suffixzURL.with_suffixs&#&12 2 &)s*fmvj9: :}}x'9:; ;__ $.tf}D9KC O;K4Lv4U~~d##r5ct|tur td|j}|j}|jxs |j}||jk7s|t vr|S|j r)|tvr!|j|j|Sd|i}|js |jr|j|d<|js |jr|j|d<|js!|j|jdi|S|jddk(r |j}n|jsd|j}nu|jddk(r|j|j}nHdjg|jd dd }||jz }|jddk(r|d d }d |vr|j|n||d <|j|jdi|S)u_Join URLs Construct a full (“absolute”) URL by combining a “base URL” (self) with another URL (url). Informally, this uses components of the base URL, in particular the addressing scheme, the network location and (part of) the path, to provide missing components in the relative URL. zurl should be URLrmr9r=r<rrrpNrrrror;r4)rrBrr{r9 USES_RELATIVEr:rrrr;r=r<r0rZr)rrr other_valr9rZr;s r6r0zURL.joins 9C /0 0iiHH !!/SZZ SZZ 6#>J   . 8>>)"4"4F"4"CD D#+V"4 >>Y// ) 2 2E*  >>Y__&__E'N~~>>,#,,"7"78 8 >>!  #>>Dy~~&'D XXb\S hhZ /0D 882djj"o2r23D INN "Dxx{c!ABx69Tk,,T2tf ~~lcll3U344r5c(|j||S)zAReturn a new URL with the elements in other appended to the path.ry)r)rrrs r6joinpathz URL.joinpath&sw77r5ct|jd}t|jd}|jx}r d|vrd|d}t|jd}t r|Jdj d|jjD}t|jd}t r|J|j||||j}|jj}|j|||||S) z.3s5 1 NN<73\!W5M N s35rr)rrIrKrMr;r r0r<r|r=rrPr{r9r) rrIrKrMr;rUr=r:r9s r6 human_reprzURL.human_repr*sDIIy1 y9II D 3$;tfA;DDIIt, # ##xx  ((*    r2 ' ''""449K9KL!!##FFD,QQr5)rrrgN)rgrB)rgrS)F)rrBrgrB)~r/r0r1 __slots__rrarrrrrrrrrrrrr!rr3rr>rbr)r classmethodrcQueryrrrr staticmethodrrrrrrrrrrrrrrrerrrrrrcached_propertyrCrrDr9rErFrGrHrIrJrKrLrMrNrOrPrQr;rrdrRr<rTrUrVrWrXr=rYrZr[r\r]r^r_r`rarrrrrUrrrrorrrtrvrxr{rr QueryVariablerrrr rrrrrrrrrr0rrr4r5r6rBrBs N#Ie$G IeDL$$7N6dERM6VEO fuEFE: f- Ic*N#4<%L /1V$( V 3 U* +V V dDj! V  Vp!%%)!%$(UU U CI U T " UUCIUUUD[!UUUU UUnKEM K K 8 8  8'* 836 8BE 8  8 8;#;)5) F t #'F't' &F&t& 'F't' &F&t& ... (U(u(I$IeK01 T .."##$ # &$ & &    s  3uS$Y/33Q3QQ'%T *'' (eCI& ( (+eCI.++ ,%T * , , '%T * ' ' !eCI& ! !15d#311*8eCI&88,uS$Y/,, #  2c227377BtE#s(O4BB==#2c22222 4S44 "c""2#22 &5c? & &FuS#XFF # # #  -c--C///EeCHoEEM%S/MM "X"X4"XE"XH E3 E3 E E77 tS%d +S#s: ;772,(,(D,(S,(,(\ 0CI0T "0CI 0 CI 0  0 00BBB uS$YsDy!15d3CU3PT9EUU VBBB G# G% G;eCI.;5;.AeCI&6A5A,;c;e;,;eCI.;5;&7<TcTtTTeCI. =>? , m   0eE#t)$4c$9:; &! C! 3! 5d;K! F44%44 ?=?U??CCsCuC$6%6E66 A]AuAAC#CCC06%6E66 A]AuAAA#AAA&  #  %  IeCI&6I5I& c e >$#$%$$35j5:8s8T8e8RCRr5rBrrc|s|Sd|zD]&}||vs|j|dt|d}(|jr|Sdjd|DS)NrO02Xrrc3VK|]!}|jr|n t|#ywr) isprintabler)r+cs r6r-z_human_quote..Gs!A! 1U1X5As'))replaceordrr0)rrrs r6rr?sf  6\/ 6 !qQ -.A/ }} 77AqA AAr5rc tj|jdS#t$r#|jdjdcYSwxYw)Nridna)rdecoder UnicodeError)rs r6rrMsH2{{3::g.// 2zz'"))&112s#&)AArMc tj|djdS#t$r#|jdjdcYSwxYw)NT)uts46rr)rrrr)rMs r6rZrZUsL3{{4t,33G<< 3{{6"))'223s%()AAr\cHt|}|j|jfS)z8Return compressed version of IP address and its version.)r compressedr_)r\ips r6rXrX]s! F B =="** $$r5c tj|}|y|j|jd}}}|dk(s |dk(r d||dvrd}t d|d|d|d |d) zValidate an ascii host name.NrrrrzQ, if the value includes a username or password, use 'authority' instead of 'host'zHost z cannot contain z (at position )) _not_reg_namesearchgroupstartr)rMinvalidrposextras r6rYrYds""4(G "3E | ST ): 0   x'y3%qP  r5ctjtjtjtjy)zClear all LRU caches.N)r cache_clearrZrXrYr4r5r6rrvs4&&( r5ctjtjtjtjdS)zReport cache statistics.)r,r-r r.)rZ cache_inforrXrYr4r5r6rrs>$..0#..0,779'224  r5idna_encode_sizeidna_decode_sizeip_address_sizehost_validate_sizerrrrct|tjat|tjat|tjat|t jay)zConfigure LRU cache sizes.N)rrZ __wrapped__rrXrYrs r6cache_configurersi/9-.|/G/GHL.9-.|/G/GHL7Y7**3Y12>3M3MNNr5r)Nrresysrcollections.abcrrr contextlibr functoolsrr ipaddressr typingr r r r rrrr urllib.parserrrrrrr multidictrrr propcache.apirr_quotingrrr frozensetrrrrsentinelcompileVERBOSErr>rcr SimpleQueryrrr& version_infor)r+r8rArjrdrxrBr _MAXCACHErrZrerXrYrrrr4r5r6rs 77+     55B(cCK ;'-( !!FG 8  JJ  CeO$ k#::;  #,.SS  T]w D y# #Lr 490]R]R]R@-BE#t)$BcBeCI6FB   92c2c22 93s3s33 9%3%5c?%%  9"!!I*3)2(1+4 OCI&OCI&O39% O c4i( O  OOr5