o …ªRhÔã@shddlZddlZddlZddlmZmZddlmZddlm Z m Z ddl m Z ddl mZmZmZmZmZmZddlmZmZmZddlZddlmZmZdd lmZd d lm Z m!Z!m"Z"m#Z#m$Z$m%Z%d d l&m'Z'm(Z(d d l)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/d dl0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;me?eƒZ@e?dƒZAe BdejC¡ZDedƒZEejFdkrÁddl mGZGneZGGdd„deƒZHeHjIZJGdd„deƒZKGdd„deddZLdeEd eEfd!d"„ZMe d#eNd d$fd%d&„ƒZOe d#eNd d$fd'd(„ƒZPe d)eNd*eNd+eeNdfd,eeNdfd-eNd.eeQdfd/eNd0eNd1eNd d$fd2d3„ƒZRd)eNd4eNd/eNd5eNd1eNd d$f d6d7„ZSe eSƒZTeMGd8d$„d$ƒƒZUd9ZVd:ZWe eVƒd;eNd eNfdd?„ƒaYe eWƒd-eNd@eZd eNfdAdB„ƒa[eMdOdCdD„ƒZ\eMd eKfdEdF„ƒZ]eMeVeVeJeJeJdGœdHeeQdfdIeeQdfdJeeQdeHfdKeeQdeHfdLeeQdeHfd df dMdN„ƒZ^dS)PéN)ÚMappingÚSequence)ÚEnum)Ú _CacheInfoÚ lru_cache)Ú ip_address)Ú TYPE_CHECKINGÚAnyÚ TypedDictÚTypeVarÚUnionÚoverload)Ú SplitResultÚ parse_qslÚ uses_relative)Ú MultiDictÚMultiDictProxy)Úunder_cached_propertyé)ÚUSES_AUTHORITYÚ SplitURLTypeÚ make_netlocÚ split_netlocÚ split_urlÚunsplit_result)Únormalize_pathÚnormalize_path_segments)ÚQueryÚ QueryVariableÚ SimpleQueryÚ get_str_queryÚget_str_query_from_iterableÚ$get_str_query_from_sequence_iterable) ÚFRAGMENT_QUOTERÚFRAGMENT_REQUOTERÚ PATH_QUOTERÚ PATH_REQUOTERÚPATH_SAFE_UNQUOTERÚ PATH_UNQUOTERÚ QS_UNQUOTERÚ QUERY_QUOTERÚQUERY_REQUOTERÚQUOTERÚREQUOTERÚUNQUOTERÚ human_quoteéPi»é)ÚhttpÚhttpsÚwsÚwssÚftpa< # 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}) Ú_T)éé )ÚSelfc@seZdZdZdZdS)Ú UndefinedTypez4Singleton type for use with not set sentinel values.rN)Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú _singleton©rArAúK/home/air/sanwanet/backup_V2/venv/lib/python3.10/site-packages/yarl/_url.pyr;Psr;c@s:eZdZUdZeed<eed<eed<eed<eed<dS)Ú CacheInfozHost encoding cache.Ú idna_encodeÚ idna_decoderÚ host_validateÚ encode_hostN)r<r=r>r?rÚ__annotations__rArArArBrCYs  rCc@s¢eZdZUeed<ded<eed<eed<eed<eed<eedfed <eedfed <eedfed <eedfed <eedfed <eedfed<eedfed<eedfed<eedfed<eedfed<eed<eed<e e eefed<ded<eed<eed<eed<eed<eed<eed<e edfed<e edfed <ded!<eed"<eed#<eed$<eed%<e edfed&<e edfed'<dS)(Ú_InternalURLCacheÚ_valÚURLÚ_originÚabsoluteÚschemeÚ raw_authorityÚ authorityNÚraw_userÚuserÚ raw_passwordÚpasswordÚraw_hostÚhostÚhost_subcomponentÚhost_port_subcomponentÚportÚ explicit_portÚraw_pathÚpathÚ _parsed_queryúMultiDictProxy[str]ÚqueryÚraw_query_stringÚ query_stringÚpath_qsÚ raw_path_qsÚ raw_fragmentÚfragment.Ú raw_partsÚpartsÚparentÚraw_nameÚnameÚ raw_suffixÚsuffixÚ raw_suffixesÚsuffixes) r<r=r>rrHÚboolÚstrr ÚintÚlistÚtuplerArArArBrIcsH rIF)ÚtotalÚobjÚreturncCs d|_|S)NÚyarl)r=)rurArArBÚrewrite_module‰srxÚurl_strrKcCsÂi}t|ƒ\}}}}}|sd}n†d|vsd|vsd|vr%t|ƒ\}} }} nd}} } |}|durA|tvr?d|›d} t| ƒ‚d}t|dd }d|vrQ|d d …n||d <| |d <| durw|durw| durg|n|›d| ›}d|d<d|d<n|r}t|ƒn|} | r…t| ƒn| } t| | || ƒ}| |d<| |d<|r¦t|ƒ}|r¦d|vr¦t|ƒ}|r¬t |ƒ}|r²t |ƒ}||d<|s¼|r¼dn||d<||d<||d<t   t ¡}||_||_||_||_||_||_|S)zParse unencoded URL.Úú:ú@ú[Nz9Invalid URL: host is required for absolute urls with the ú schemeF©Ú validate_hostréÿÿÿÿrUrZrQrSÚ.rNú/r[r`rd)rrÚSCHEME_REQUIRES_HOSTÚ ValueErrorÚ _encode_hostr-rr&rr+r$ÚobjectÚ__new__rKÚ_schemeÚ_netlocÚ_pathÚ_queryÚ _fragmentÚ_cache)ryÚcacherNÚnetlocr\r_rerVÚusernamerTrYÚmsgrQrSÚselfrArArBÚ encode_urlŽs` ÿÿ    r”cCs4t t¡}t|ƒ}|\|_|_|_|_|_i|_ |S)zParse pre-encoded URL.) r‡rˆrKrr‰rŠr‹rŒrrŽ)ryr“ÚvalrArArBÚpre_encoded_urlÎs r–rNrPrRrTrVrYr\rarec Cs t t¡} || _|r|| _n4|r?|dur|t |¡krdn|}|dur6|dur6|dur-|n|›d|›| _n t||||ƒ| _nd| _|| _|| _ || _ i| _ | S)z#Build a pre-encoded URL from parts.Nr{rz) r‡rˆrKr‰rŠÚ DEFAULT_PORTSÚgetrr‹rŒrrŽ) rNrPrRrTrVrYr\rarer“rArArBÚbuild_pre_encoded_urlØs r™rr_cCs2t t¡}||_||_||_||_||_i|_|S)zCreate a new URL from parts.) r‡rˆrKr‰rŠr‹rŒrrŽ)rNrr\r_rer“rArArBÚfrom_parts_uncachedùs ršc@s eZdZUdZeed<eed<eed<eed<eed<efddd œd eeede fd e d ee dfd dfdd„Z e ddddddddddddœ dededeedfdeedfdedee dfdedeedfdeded e d dfdd„ƒZdd„Zd efd d!„Zd efd"d#„Zd efd$d%„Zd&ed e fd'd(„Zd e fd)d*„Zd&ed e fd+d,„Zd&ed e fd-d.„Zd&ed e fd/d0„Zd&ed e fd1d2„Zd3ed dfd4d5„Zded dfd6d7„Zd e fd8d9„Zd eefd:d;„Z dd?„Z"d e fd@dA„Z#d e fdBdC„Z$dÇdDdE„Z%e&d e'fdFdG„ƒZ(e&dÇdHdI„ƒZ)dÇdJdK„Z*e&d e fdLdM„ƒZ+e&d efdNdO„ƒZ,e&d efdPdQ„ƒZ-e&d efdRdS„ƒZ.e&d eedffdTdU„ƒZ/e&d eedffdVdW„ƒZ0e&d eedffdXdY„ƒZ1e&d eedffdZd[„ƒZ2e&d eedffd\d]„ƒZ3e&d eedffd^d_„ƒZ4e&d eedffd`da„ƒZ5e&d eedffdbdc„ƒZ6e&d ee dffddde„ƒZ7e&d ee dffdfdg„ƒZ8e&d efdhdi„ƒZ9e&d efdjdk„ƒZ:e&d efdldm„ƒZ;e&d ee&d efdsdt„ƒZ?e&d efdudv„ƒZ@e&d efdwdx„ƒZAe&d efdydz„ƒZBe&d efd{d|„ƒZCe&d efd}d~„ƒZDe&d eedffd€d„ƒZEe&d eedffd‚dƒ„ƒZFe&dÇd„d…„ƒZGe&d efd†d‡„ƒZHe&d efdˆd‰„ƒZIe&d efdŠd‹„ƒZJe&d efdŒd„ƒZKe&d eedffdŽd„ƒZLe&d eedffdd‘„ƒZMdÉd’d“d e d dfd”d•„ZNded dfd–d—„ZOdeedfd dfd˜d™„ZPdeedfd dfdšd›„ZQded dfdœd„ZRdee dfd dfdždŸ„ZSdddd œded e d¡e d¢e d df d£d¤„ZTeUded dfd¥d¦„ƒZVeUd§eWd dfd¨d¦„ƒZVd©eXd§eXd dfdªd¦„ZVeUded dfd«d¬„ƒZYeUd§eWd dfd­d¬„ƒZYd©eXd§eXd dfd®d¬„ZYeUded dfd¯d°„ƒZZeUd§eWd dfd±d°„ƒZZd©eXd§eXd dfd²d°„ZZd³ed dfd´dµ„Z[deedfd dfd¶d·„Z\ddd¸œd3ed¡e d¢e d dfd¹dº„Z]ddd¸œd»ed¡e d¢e d dfd¼d½„Z^dÊd¿dÀ„Z_ddÁœd&ed e d dfdÂdÄZ`d efdÄdÅ„ZadS)ËrK)rŽr‰rŠr‹rŒrr‰rŠr‹rŒrFN)ÚencodedÚstrictr•r›rœrvcCsÊ|dur t d¡t|ƒtur|rt|ƒSt|ƒSt|ƒ|ur!|St|ƒtur1|s-tdƒ‚t|ŽSt |tƒrD|r>tt|ƒƒStt|ƒƒS|t urat   t ¡}d|_|_|_|_|_i|_|Stdƒ‚)Nzstrict parameter is ignoredz$Cannot apply decoding to SplitResultrzz#Constructor parameter should be str)ÚwarningsÚwarnÚtyperpr–r”rr…Ú from_partsÚ isinstanceÚ UNDEFINEDr‡rˆrKr‰rŠr‹rŒrrŽÚ TypeError)Úclsr•r›rœr“rArArBrˆYs$      z URL.__new__rz) rNrPrRrTrVrYr\r_rarer›rNrPrRrTrVrYr\r_rarec  Csü|r|s |s |s |rtdƒ‚|dur!t|tƒs!tdt|ƒ›dƒ‚|r)|s)tdƒ‚|r1| r1tdƒ‚|dusI|dusI|dusI|dusI| dusI| durMtdƒ‚|rUt|ƒpTd} | rct|||||||| | ƒ St t ¡} || _ d} |r‚t |ƒ\}}} }| rt | d d nd} n |r‹t |d d } nd| _ | durÁ|dur¡|t |¡krŸdn|}|dur¸|dur¸|dur¯| n| ›d |›| _ n t||| |d ƒ| _ |rÇt|ƒn|}|râ| j râd|vrÖt|ƒ}|d dkrâd}t|ƒ‚|| _|sí| rít| ƒ} | | _| röt| ƒn| | _i| _| S)zCreates and returns a new URLz@Can't mix "authority" with "user", "password", "host" or "port".Nz$The port is required to be int, got r‚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.rzFrTr{rrƒzCPath in a URL with authority should start with a slash ('/') if set)r…r¡rqr£rŸr r™r‡rˆrKr‰rr†rŠr—r˜rr%rr‹r*rŒr#rrŽ)r¤rNrPrRrTrVrYr\r_rarer›r“Ú_hostr’rArArBÚbuildvs~ÿÿ ÷   ÿz URL.buildcCstd|›dƒ‚)NzInheriting a class z from URL is forbidden)r£)r¤rArArBÚ__init_subclass__ÕózURL.__init_subclass__cCsx|js|jr|js |jrd}n|j}|j}dur.|t |j¡kr.|j}t |j |j |dƒ}n|j}t |j|||j|jƒS©Nrƒ) r‹rŠrŒrrZr—r˜r‰rWrrQrSr)r“r\rYrVrrArArBÚ__str__Øsÿz URL.__str__cCs|jj›dt|ƒ›dS)Nz('z'))Ú __class__r<rp©r“rArArBÚ__repr__èsz URL.__repr__cCst|ƒ d¡S)NÚascii)rpÚencoder¬rArArBÚ __bytes__ësz URL.__bytes__ÚothercCstt|ƒturtS|js|jrdn|j}|js|jrdn|j}|j|jko9|j|jko9||ko9|j|jko9|j|jkSr©)rŸrKÚNotImplementedr‹rŠr‰rŒr)r“r±Úpath1Úpath2rArArBÚ__eq__îs   ÿþ ý ûz URL.__eq__cCsR|j d¡}dur'|js|jrdn|j}t|j|j||j|jfƒ}|jd<|S)NÚhashrƒ)rŽr˜r‹rŠr¶r‰rŒr)r“Úretr\rArArBÚ__hash__üs ÿz URL.__hash__cCst|ƒturtS|j|jkS©N©rŸrKr²rJ©r“r±rArArBÚ__le__ó  z URL.__le__cCst|ƒturtS|j|jkSr¹rºr»rArArBÚ__lt__ r½z URL.__lt__cCst|ƒturtS|j|jkSr¹rºr»rArArBÚ__ge__r½z URL.__ge__cCst|ƒturtS|j|jkSr¹rºr»rArArBÚ__gt__r½z URL.__gt__rjcCst|tƒstS| t|ƒf¡Sr¹)r¡rpr²Ú _make_child©r“rjrArArBÚ __truediv__s zURL.__truediv__cCs | |¡Sr¹)Ú update_query©r“r_rArArBÚ__mod__s z URL.__mod__cCst|jp |jp |jp |jƒSr¹)rorŠr‹rŒrr¬rArArBÚ__bool__ sz URL.__bool__cCst t|j¡fSr¹)rsrˆrrJr¬rArArBÚ __getstate__#r¨zURL.__getstate__cCsR|ddurt|dtƒr|dd}n|^}}|\|_|_|_|_|_i|_dS)NrrrJ)r¡Údictr‰rŠr‹rŒrrŽ)r“Ústater•ÚunusedrArArBÚ __setstate__&s  zURL.__setstate__cCs0|j}t|jƒ}|\|d<|d<|d<|d<dS)z"Cache the netloc parts of the URL.rQrSrUrZN)rŽrrŠ)r“ÚcÚ split_locrArArBÚ _cache_netloc/s  zURL._cache_netloccCó|jS)záA 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. )rMr¬rArArBÚ is_absolute5s zURL.is_absolutecCs(|j}dur |jdkS|t |j¡kS)zßA 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. Nrz)rZrŠr—r˜r‰)r“ÚexplicitrArArBÚis_default_port@s zURL.is_default_portcCrÐ)z}Return an URL with scheme, host and port parts only. user, password, path, query and fragment are removed. )rLr¬rArArBÚoriginQóz URL.origincCs|j|j|j|j|jfSr¹)r‰rŠr‹rŒrr¬rArArBrJZszURL._valcCsj|j}s tdƒ‚|j}stdƒ‚d|vr"|j}tdd||jƒ}n |js-|js-|js-|St ||dddƒ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 schemer|Nrz) rŠr…r‰rWrrZr‹rŒrr )r“rrNÚ encoded_hostrArArBrL^s  z URL._origincCs$|jstdƒ‚tdd|j|j|jƒS)zhReturn a relative part of the URL. scheme, user, password, host and port are removed. rÖrz)rŠr…r r‹rŒrr¬rArArBÚrelativeosz URL.relativecCs |jdkS)z‰A check for absolute URLs. Return True for absolute ones (having scheme or starting with //), False otherwise. rz©rŠr¬rArArBrMys z URL.absolutecCrÐ)zdScheme for absolute URLs. Empty string for relative URLs or URLs starting with // )r‰r¬rArArBrN‡rÕz URL.schemecCrÐ)zQEncoded authority part of URL. Empty string for relative URLs. rÙr¬rArArBrOrÕzURL.raw_authoritycCst|j|j|j|jƒS)zQDecoded authority part of URL. Empty string for relative URLs. )rrRrTrVrYr¬rArArBrP™óz URL.authoritycCó| ¡|jdS)zEEncoded user part of URL. None if user is missing. rQ©rÏrŽr¬rArArBrQ¢s z URL.raw_usercCó|j}dur dSt|ƒS)zEDecoded user part of URL. None if user is missing. N)rQr.)r“rQrArArBrR­ózURL.usercCrÛ)zMEncoded password part of URL. None if password is missing. rSrÜr¬rArArBrS¸ó zURL.raw_passwordcCrÝ)zMDecoded password part of URL. None if password is missing. N)rSr.)r“rSrArArBrTÂrÞz URL.passwordcCrÛ)zÚEncoded 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. rUrÜr¬rArArBrUÍs z URL.raw_hostcCs6|j}dur dS|r|d ¡sd|vr|St|ƒS)zDDecoded host part of URL. None for relative URLs. Nrr{)rUÚisdigitÚ _idna_decode©r“ÚrawrArArBrVÛs zURL.hostcCs*|j}dur dSd|vrd|›dS|S)aÑReturn 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]` Nr{r}ú])rUrârArArBrWészURL.host_subcomponentcCs„|j}dur dS|ddkr| d¡}|j}|dus#|t |j¡kr/d|vr-d|›dS|Sd|vr;d|›d|›S|›d|›S)aReturn the host and port subcomponent part of URL. Trailing dots are removed from the host part. This value is suitable for use in the Host header of an HTTP request. None for relative URLs. https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2 `IP-literal = "[" ( IPv6address / IPvFuture ) "]"` https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.3 port = *DIGIT Examples: - `http://example.com:8080` -> `example.com:8080` - `http://example.com:80` -> `example.com` - `http://example.com.:80` -> `example.com` - `https://127.0.0.1:8443` -> `127.0.0.1:8443` - `https://[::1]:8443` -> `[::1]:8443` - `http://[::1]` -> `[::1]` Nrr‚r{r}räz]:)rUÚrstriprZr—r˜r‰)r“rãrYrArArBrXÿs  &zURL.host_port_subcomponentcCs|j}dur |St |j¡S)z«Port part of URL, with scheme-based fallback. None for relative URLs or URLs without explicit port and scheme without default port substitution. N)rZr—r˜r‰)r“rZrArArBrY%s zURL.portcCrÛ)zyPort part of URL, without scheme-based fallback. None for relative URLs or URLs without explicit port. rZrÜr¬rArArBrZ1rßzURL.explicit_portcCs|js|js |jSdS)zNEncoded path of URL. / for absolute URLs without path part. rƒ)r‹rŠr¬rArArBr[;rÚz URL.raw_pathcCó|jrt|jƒS|jr dSdS)zNDecoded path of URL. / for absolute URLs without path part. rƒrz)r‹r(rŠr¬rArArBr\DszURL.pathcCræ)z{Decoded path of URL. / for absolute URLs without path part. / (%2F) and % (%25) are not decoded rƒrz)r‹r'rŠr¬rArArBÚ path_safeMs z URL.path_safecCst|jddS)zParse query part of URL.T©Úkeep_blank_values)rrŒr¬rArArBr]ZszURL._parsed_queryr^cCstt|jƒƒS)z‘A MultiDictProxy representing parsed query parameters in decoded representation. Empty value if URL has no query part. )rrr]r¬rArArBr__sz URL.querycCrÐ)zOEncoded query part of URL. Empty string if query is missing. )rŒr¬rArArBr`irÕzURL.raw_query_stringcCó|jrt|jƒSdS)zODecoded query part of URL. Empty string if query is missing. rz)rŒr)r¬rArArBrarózURL.query_stringcCs |j}s|jS|j›d|›S)zDecoded path of URL with query.ú?)rar\©r“ÚqrArArBrb{s z URL.path_qscCsF|j}r|js |js|j›d|›Sd|›S|js|js!|jSdS)zEncoded path of URL with query.rìz/?rƒ)rŒr‹rŠrírArArBrc€s &zURL.raw_path_qscCrÐ)zUEncoded fragment part of URL. Empty string if fragment is missing. )rr¬rArArBrd‡rÕzURL.raw_fragmentcCrê)zUDecoded fragment part of URL. Empty string if fragment is missing. rz)rr.r¬rArArBrerëz URL.fragment.cCsf|j}|jr|rdg|dd… d¡¢RSdS|r,|ddkr,dg|dd… d¡¢RSt| d¡ƒS)zjA tuple containing encoded *path* parts. ('/',) for absolute URLs if *path* is missing. rƒrN)rƒr)r‹rŠÚsplitrs)r“r\rArArBrf™s "z URL.raw_partscCótdd„|jDƒƒS)zjA tuple containing decoded *path* parts. ('/',) for absolute URLs if *path* is missing. csó|]}t|ƒVqdSr¹©r.)Ú.0ÚpartrArArBÚ ®ó€zURL.parts..)rsrfr¬rArArBrg§rëz URL.partscCsb|j}|r |dkr|js|jrt|j|j|ddƒS|S| d¡}t|j|jd |dd…¡ddƒS)z]A new URL with last part of path removed and cleaned up query and fragment. rƒrzNr)r‹rrŒr r‰rŠrïÚjoin)r“r\rgrArArBrh°s   "z URL.parentcCs0|j}|js |dS|dd…}|r|dSdS)zThe last part of raw_parts.rrNrz)rfrŠ)r“rgrArArBri¾s  z URL.raw_namecCó t|jƒS)zThe last part of parts.)r.rir¬rArArBrjÇs zURL.namecCs@|j}| d¡}d|krt|ƒdkrnn||d…SdS)Nr‚rrrz)riÚrfindÚlen)r“rjÚirArArBrkÌs 0zURL.raw_suffixcCrør¹)r.rkr¬rArArBrlÒs z URL.suffixcCs>|j}| d¡r dS| d¡}tdd„| d¡dd…DƒƒS)Nr‚rAcss|]}d|VqdS)r‚NrA©rórlrArArBrõÜröz#URL.raw_suffixes..r)riÚendswithÚlstriprsrïrÂrArArBrmÖs    zURL.raw_suffixescCrð)Ncsrñr¹ròrürArArBrõàrözURL.suffixes..)rsrmr¬rArArBrnÞsz URL.suffixesÚpathsz Sequence[str]c Csbg}d}tt|ƒƒD]A\}}|dk}|r"|ddkr"td|›dƒ‚|r&|nt|ƒ}|d|vO}| d¡}| ¡||sH|ddkrH|dd …n|7}q |j}rn| d¡} rn| d dkrd| d d …n| } |  ¡|| 7}|j} r€|r€|d dkr€| d¡| ¡| rˆ|s”t |j | d  |¡ddƒSd  t |ƒ¡}|r¨|ddkr¨d|›}t |j | |ddƒS) z’ add paths to self._path, accounting for absolute vs relative paths, keep existing, but do not create new, empty segments FrrƒzAppending path z! starting from slash is forbiddenr‚rzrNr) Ú enumerateÚreversedr…r%rïÚreverser‹rŠÚappendr r‰r÷r) r“rÿr›ÚparsedÚneeds_normalizeÚidxr\ÚlastÚsegmentsÚ old_segmentsÚoldrrArArBrÁâs4 ÿ  &  zURL._make_childcCsVt|tƒs tdƒ‚| ¡}|j}|s |tvr d|›d}t|ƒ‚t|||j|j |j ƒS)z&Return a new URL with scheme replaced.zInvalid scheme typez>> 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') rú&)r rŒršr‰rŠr‹r)r“rrÚ new_queryr_rArArBr¦s   ÿcCrr¹rArÅrArArBrļrzURL.update_querycKrr¹rArrArArBrÄ¿rc Os|r |r d}t|ƒ‚|}nt|ƒdkr|d}ntdƒ‚|dur#d}n^|s)|j}nXt|tƒr?t|jƒ}| |¡t|  ¡ƒ}nBt|t ƒrYt|jƒ}| t |dd¡t |  ¡ƒ}n(t|t ttfƒrgd}t|ƒ‚t|tƒr}t|jƒ}| |¡t |  ¡ƒ}ntd ƒ‚t|j|j|j||jƒ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') z7Either kwargs or single query parameter must be presentrrNrzTrèzAInvalid query type: bytes, bytearray and memoryview are forbiddenzRInvalid query type: only str, mapping or sequence of (key, value) pairs is allowed)r…rúrŒr¡rrr]Úupdater"Úitemsrprr!ÚbytesÚ bytearrayÚ memoryviewr£rršr‰rŠr‹r) r“rrr’Úin_queryr_ÚqmÚqstrÚqsrArArBrÄÂsB           ÿÿÚ query_paramscs<t|ƒ|j ¡@‰ˆs |S| t‡fdd„|j ¡Dƒƒ¡S)z4Remove some keys from query part and return new URL.c3s$|] \}}|ˆvr||fVqdSr¹rA)rórjÚvalue©Úparams_to_removerArBrõýs€þýz+URL.without_query_params..)Úsetr_Úkeysrrsr)r“r'rAr)rBÚwithout_query_params÷s þÿzURL.without_query_paramscCsN|durd}n t|tƒstdƒ‚t|ƒ}|j|kr|St|j|j|j|j |ƒS)zReturn a new URL with fragment replaced. Autoencode fragment if needed. Clear fragment to default if None is passed. NrzzInvalid fragment type) r¡rpr£r#rr r‰rŠr‹rŒ)r“rerdrArArBÚ with_fragments   ÿzURL.with_fragment©rrcCsÈt|tƒs tdƒ‚d|vrtdƒ‚t|ƒ}|dvrtdƒ‚t|jƒ}|j}r.rz)r/rRrTrVr\rr÷r_rrerrZrr‰)r“rRrTrVr\rarerrArArBÚ human_reprs      þ  zURL.human_repr©rvN)rvrK)rvr^)F)r3rKrvrK)br<r=r>Ú __slots__rprHr¢r rr;rorˆÚ classmethodrqrr¦r§rªr­r r°r‡rµr¸r¼r¾r¿rÀrÃrÆrÇrsrÈrÌrÏrÑrÓrÔÚcached_propertyrrJrLrØrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\rçrrr]r_r`rarbrcrdrerfrgrhrirjrkrlrmrnrÁr rrrrrr rrr rrÄr-r.r0r2r÷r9r=rArArArBrK s¦ Gþûþü û úóýü û úù ø ÷ ö õ ô ó ò^             %        /úþüûú ù5 ûþüû ú*ûþüû ú 4éirãcCs6z t | d¡¡WSty| d¡ d¡YSw)Nr®Úidna)rCÚdecoder¯Ú UnicodeError)rãrArArBrá¨s  ÿrácCs:z tj|dd d¡WSty| d¡ d¡YSw)NT)Úuts46r®rC)rCr¯rDrE)rVrArArBÚ _idna_encode°s  ÿrGr€c Cs|rH|d ¡s d|vrH| d¡\}}}zt|ƒ}Wn ty#Yn%w|j}|jdkr=|r7d|›d|›dSd|›dS|rF|›d|›S|S| ¡rŠ| ¡}|rˆt  |¡}rˆ|  ¡|  ¡d}}} |dksu|dkrwd||d …vrwd } td |›d |›d |›d| ›ƒd ‚|St |ƒS)zEncode host part of URL.rr{ú%ér}rärzr|NzQ, if the value includes a username or password, use 'authority' instead of 'host'zHost z cannot contain z (at position ú)) ràÚ partitionrr…Ú compressedÚversionÚisasciir Ú NOT_REG_NAMEÚsearchÚgroupÚstartrG) rVr€Úraw_ipÚsepÚzoneÚipÚinvalidr(ÚposÚextrarArArBr†¸s2  ÿ " ÿÿþr†cCst ¡t ¡t ¡dS)zClear all LRU caches.N)rGÚ cache_clearrár†rArArArBrZòs rZcCs$t ¡t ¡t ¡t ¡t ¡dœS)zReport cache statistics.)rDrErrFrG)rGÚ cache_inforár†rArArArBr[ús ûr[)Úidna_encode_sizeÚidna_decode_sizeÚip_address_sizeÚhost_validate_sizeÚencode_host_sizer\r]r^r_r`cCsØ|tus|turtjdtdd|durL||fD]-}|dur!d}q|tur,|tur+|}q|turEtr@t|tƒs9J‚t|tƒs@J‚t||ƒ}q|turLt}trUt|t ƒrUJ‚t |ƒt j ƒa t |ƒt j ƒa t |ƒtj ƒadS)zConfigure LRU cache sizes.z¬cache_configure() no longer accepts the ip_address_size or host_validate_size arguments, they are used to set the encode_host_size instead and will be removed in the futureé)Ú stacklevelN)r¢rržÚDeprecationWarningrr¡rqÚmaxÚ_DEFAULT_ENCODE_SIZEr‡rr†Ú __wrapped__rárG)r\r]r^r_r`ÚsizerArArBÚcache_configures6 ú € €rhr>)_ÚreÚsysrÚcollections.abcrrÚenumrÚ functoolsrrÚ ipaddressrÚtypingrr r r r r Ú urllib.parserrrrCÚ multidictrrÚ propcache.apirrAÚ_parserrrrrrr‹rrrŒrrrr r!r"Ú_quotersr#r$r%r&r'r(r)r*r+r,r-r.r/r—Ú frozensetr4r„ÚcompileÚVERBOSErOr7Ú version_infor:r;r@r¢rCrIrxrpr”r–rqr™ršr rKÚ_DEFAULT_IDNA_SIZErerárGror†rZr[rhrArArArBÚsä      < ö  &? ÿþ ý üû úùø ÷ ö ÿÿÿÿÿ þ"9  ú þ ý ü û úù