o n~b@s*ddlZddlZddlZddlmZmZddlmZddlm Z m Z m Z m Z m Z mZddlmZmZddlZddlZddlmZmZdd dd d ZeZd ed efd dZGdddZeGdddZddZdZeedda eedda!eddZ"eddZ#eeeddd Z$dS)!N)MappingSequence) ip_address) SplitResult parse_qslurljoinurlsplit urlunsplitquote) MultiDictMultiDictProxy)_Quoter _UnquoterPi)httphttpswswssobjreturncCs d|_|S)NZyarl) __module__)rr4/usr/local/lib/python3.10/dist-packages/yarl/_url.pyrewrite_modulesrc@s,eZdZdZddZefddZddZdS) cached_propertyaRUse as a class method decorator. It operates almost exactly like the Python `@property` decorator, but it puts the result of the method it decorates into the instance dict after the first call, effectively replacing the function it decorates with an instance variable. It is, in Python parlance, a data descriptor. cCs8||_z|j|_Wn tyd|_Ynw|j|_dS)N)wrapped__doc__AttributeError__name__name)selfrrrr__init__$s    zcached_property.__init__cCsB|dur|S|j|j|}||ur|S||}||j|j<|SN)_cachegetr!r)r"instowner _sentinelvalrrr__get__,s  zcached_property.__get__cCstd)Nzcached property is read-only)r)r"r'valuerrr__set__6zcached_property.__set__N)r r __qualname__rr#sentinelr+r-rrrrrs   rc @speZdZdZeddZeZeddddZedddZedd d dd Z edd d d Z edd dd Z edddZ eddZ eZeddZed dZddddddZedddddddddddd ddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Z d3e!fd4d5Z"d6d7Z#d8d9Z$d:d;Z%dd?Z'd@dAZ(e)dBdCZ*e)dDdEZ+e,dFdGZ-e)dHdIZ.e,dJdKZ/e)dLdMZ0e,dNdOZ1e)dPdQZ2e,dRdSZ3e)dTdUZ4e)dVdWZ5e)dXdYZ6e,dZd[Z7e,d\d]Z8e)d^d_Z9e,d`daZ:e,dbdcZ;e,dddeZe,djdkZ?e,dldmZ@e,dndoZAe,dpdqZBe,drdsZCeDdtduZEedvdwZFeGjHdxkrdeddydzZInedd{dzZIe dd|d}ZJd~dZKddZLddZMddZNddZOddddZPeddZQeDddZRddZSddZTddZUddZVddZWddZXddZYdS)URL)r%_valF)requotez@:z/+)safe protectedr3)r4r5z?/:@z=+&;T)r4r5qsr3)r4r5r6)r4r6r3)r4r3)r4+)unsafe)r6rN)encodedstrictc CsZ|dur tdt||ur|St|turt|}nt|tur)|s(tdnt|tr5tt|}ntd|s|dsDd}d}n/|j }|durOtdz|j }Wntye}ztd|d}~ww|j |j |j ||ddd }||d }|r||}|j||d ||d } ||d } t|d||| | }t|} || _i| _| S)Nzstrict parameter is ignoredz$Cannot apply decoding to SplitResultz#Constructor parameter should be strr rz/Invalid URL: host is required for absolute urlsz/Invalid URL: port can't be converted to integerT)encoder3hostpathr)warningswarntypestrrr ValueError isinstance TypeErrorhostnameport _make_netlocusernamepassword_PATH_REQUOTER_normalize_path _validate_authority_uri_abs_path_QUERY_REQUOTER_FRAGMENT_REQUOTERobject__new__r2r%) clsr*r9r:netlocr>rJer?queryfragmentr"rrrrTsX         z URL.__new__) scheme authorityuserrMr>rJr?rX query_stringrYr9c Cs@|r|s |s |s |rtd|r|std|r| rtd|dus2|dus2|dus2| dus2| dur6td|rT| r=|} n/td|ddd} |j| j| j| j| jdd} n|s_|s_|s_|s_d} n |j||||| | d } | s||}| rz| |}|j ||d | | } | | } |t|| || | dd }|r| |S|S) zCreates and returns a new URLz@Can't mix "authority" with "user", "password", "host" or "port".z/Can't build URL with "port" but without "host".z6Only one of "query" or "query_string" should be passedNzuNoneType is illegal for "scheme", "authority", "path", "query_string", and "fragment" args, use empty string instead.rT)r;)r; encode_hostr=r9)rFrHrrKrLrMrIrJ _PATH_QUOTERrOrP _QUERY_QUOTER_FRAGMENT_QUOTER with_query)rUrZr[r\rMr>rJr?rXr]rYr9rVtmpurlrrrbuilds\     z URL.buildcCstd|)Nz-Inheriting a class {!r} from URL is forbidden)rHformat)rUrrr__init_subclass__zURL.__init_subclass__cCs4|j}|js|r|js|jr|jdd}t|SN/r?)r2r? is_absoluterXrY_replacer r"r*rrr__str__ s z URL.__str__cCsd|jjt|S)Nz{}('{}'))rg __class__r rEr"rrr__repr__sz URL.__repr__cCst|dS)Nascii)rEr;rrrrr __bytes__riz URL.__bytes__cCsXt|turtS|j}|js|r|jdd}|j}|js(|r(|jdd}||kSrj)rDr1NotImplementedr2r?rmrn)r"otherZval1Zval2rrr__eq__s   z URL.__eq__cCsJ|jd}|dur#|j}|js|r|jdd}t|}|jd<|S)Nhashrkrl)r%r&r2r?rmrnry)r"retr*rrr__hash__$s  z URL.__hash__cCst|turtS|j|jkSr$rDr1rvr2r"rwrrr__le__-  z URL.__le__cCst|turtS|j|jkSr$r|r}rrr__lt__2rz URL.__lt__cCst|turtS|j|jkSr$r|r}rrr__ge__7rz URL.__ge__cCst|turtS|j|jkSr$r|r}rrr__gt__<rz URL.__gt__cCs||}|drtd||jj}|dkrd|}n|s'|s'|}n|dd}| |d |}|rB| |}t |jj |dddddS)Nrkz4Appending path {!r} starting from slash is forbiddenrr?rXrYTr_)r` startswithrFrgr2r?rmrstripsplitappendjoinrOr1rn)r"r!r?new_pathpartsrrr __truediv__As$       zURL.__truediv__cCs ||Sr$) update_query)r"rXrrr__mod__Vs z URL.__mod__rcCs$t|jjp|jjp|jjp|jjSr$)boolr2rVr?rXrYrrrrr__bool__Ysz URL.__bool__cCs|jfSr$)r2rrrrr __getstate__^r.zURL.__getstate__cCs>|ddurt|dtr|dd|_n|^|_}i|_dS)Nrr r2)rGdictr2r%)r"stateZunusedrrr __setstate__as  zURL.__setstate__cCs |jduS)zA check for absolute URLs. Return True for absolute ones (having scheme or starting with //), False otherwise. N)raw_hostrrrrrrmis zURL.is_absolutecCs0|jdurdSt|j}|durdS|j|kS)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. NF)rJ DEFAULT_PORTSr&rZ)r"defaultrrris_default_portrs   zURL.is_default_portcCsX|std|jjstd|j}|dd|j|j}|j|dddd}t|ddS)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 schemeNr)rVr?rXrYTr_) rmrFr2rZrKrIrJrnr1)r"vrVr*rrrorigins z URL.origincCs,|std|jjddd}t|ddS)zhReturn a relative part of the URL. scheme, user, password, host and port are removed. rr)rZrVTr_)rmrFr2rnr1rorrrrelatives z URL.relativecC|jjS)zdScheme for absolute URLs. Empty string for relative URLs or URLs starting with // )r2rZrrrrrrZz URL.schemecCr)zQEncoded authority part of URL. Empty string for relative URLs. )r2rVrrrrr raw_authorityrzURL.raw_authoritycCs|j|j|j|j|jddS)zQDecoded authority part of URL. Empty string for relative URLs. Fr^)rKr\rMr>rJrrrrrr[sz URL.authoritycCs|jj}|sdS|S)zEEncoded user part of URL. None if user is missing. N)r2rLr"rzrrrraw_usersz URL.raw_usercC ||jS)zEDecoded user part of URL. None if user is missing. ) _UNQUOTERrrrrrrr\ zURL.usercCr)zMEncoded password part of URL. None if password is missing. )r2rMrrrrr raw_passwordrzURL.raw_passwordcCr)zMDecoded password part of URL. None if password is missing. )rrrrrrrrMrz URL.passwordcCr)zDEncoded host part of URL. None for relative URLs. )r2rIrrrrrrs z URL.raw_hostcCs&|j}|dur dSd|vr|St|S)zDDecoded host part of URL. None for relative URLs. N%)r _idna_decode)r"rawrrrr>s zURL.hostcCs|jjp t|jjS)zPort part of URL, with scheme-based fallback. None for relative URLs or URLs without explicit port and scheme without default port substitution. )r2rJrr&rZrrrrrrJszURL.portcCr)zyPort part of URL, without scheme-based fallback. None for relative URLs or URLs without explicit port. )r2rJrrrrr explicit_portrzURL.explicit_portcCs|jj}|s |r d}|S)zNEncoded path of URL. / for absolute URLs without path part. rk)r2r?rmrrrrraw_paths z URL.raw_pathcCr)zNDecoded path of URL. / for absolute URLs without path part. )_PATH_UNQUOTERrrrrrrr?rzURL.pathcCstt|jdd}t|S)zA MultiDictProxy representing parsed query parameters in decoded representation. Empty value if URL has no query part. Tkeep_blank_values)r rraw_query_stringr rrrrrX%sz URL.querycCr)zOEncoded query part of URL. Empty string if query is missing. )r2rXrrrrrr0rzURL.raw_query_stringcCr)zODecoded query part of URL. Empty string if query is missing. ) _QS_UNQUOTERrrrrrrr]9rzURL.query_stringcC|js|jSd|j|jS)zDecoded path of URL with query.{}?{})r]r?rgrrrrrpath_qsBz URL.path_qscCr)zEncoded path of URL with query.r)rrrgrrrrr raw_path_qsIrzURL.raw_path_qscCr)zUEncoded fragment part of URL. Empty string if fragment is missing. )r2rYrrrrr raw_fragmentPrzURL.raw_fragmentcCr)zUDecoded fragment part of URL. Empty string if fragment is missing. )rrrrrrrrYYrz URL.fragmentcCs~|jj}|r!|sdg}t|Sdg|ddd}t|S|dr6dg|ddd}t|S|d}t|S)zjA tuple containing encoded *path* parts. ('/',) for absolute URLs if *path* is missing. rkr N)r2r?rmrrtuple)r"r?rrrr raw_partsbs  z URL.raw_partscstfddjDS)zjA tuple containing decoded *path* parts. ('/',) for absolute URLs if *path* is missing. c3s|]}|VqdSr$)r).0partrrrr }szURL.parts..)rrrrrrrrrvsz URL.partscCsp|j}|r |dkr|js|jrt|jjdddddS|S|d}|jjd|ddddd}t|ddS) z]A new URL with last part of path removed and cleaned up query and fragment. rkr)rXrYTr_Nr)rrrr1r2rnrr)r"r?rr*rrrparents     z URL.parentcCs2|j}|r|dd}|sdS|dS|dS)zThe last part of raw_parts.r Nrr)rrm)r"rrrrraw_names z URL.raw_namecCr)zThe last part of parts.)rrrrrrrr!s zURL.namecCs6t|dkrt|dkr|dstddSdSdS)znEnsure that path in URL with authority starts with a leading slash. Raise ValueError if not. rrkzCPath in a URL with authority should start with a slash ('/') if setN)lenrrFr=rrrrPs " z$URL._validate_authority_uri_abs_pathc Cst|d}g}|D] }|dkrz|Wq tyYq w|dkr$q ||q |ddvr5|dd|S)Nrk...rrrr)rpop IndexErrorrr)rUr?segments resolved_pathsegrrrrOs       zURL._normalize_path)r@cCsz|d\}}}t|}Wnty*|}|s|r#|YSt|}Y|Sw|j}|r6|d|7}|jdkrAd|d}|S)Nr[]) partitionrrFlowerisascii _idna_encode compressedversion)rUr>humanipsepzonerrr _encode_hosts         zURL._encode_hostcCsz|d\}}}t|}Wn'ty5|}|r|YS|D]}|dkr)nq!|YSt|}Y|Sw|j}|rA|d|7}|jdkrLd|d}|S)Nrrrr)rrrFrrrr)rUr>rrrrcharrrrrs*       c Cs|r|jn|j}|r||} n|} |r| dt|} |dur8|s%d}n|r+||}|r1||}|d|}n|r@|r@||}|rH|d| } | S)N:r@) _REQUOTER_QUOTERrrE) rUr\rMr>rJr;r^r3quoterrzrrrrKs&  zURL._make_netloccCs<t|ts td|stdt|jj|dddS)z&Return a new URL with scheme replaced.zInvalid scheme typez3scheme replacement is not allowed for relative URLs)rZTr_) rGrErHrmrFr1r2rnr)r"rZrrr with_schemes zURL.with_schemecCsn|j}|dur d}nt|tr||}|j}ntd|s$tdt|jj | |||j |j dddS)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 URLsrVTr_) r2rGrErrMrHrmrFr1rnrKrIrJ)r"r\r*rMrrr with_users   z URL.with_usercCsf|durnt|tr||}ntd|std|j}t|jj| |j ||j |j dddS)zReturn a new URL with password replaced. Autoencode password if needed. Clear password if argument is None. NzInvalid password typez5password replacement is not allowed for relative URLsrTr_) rGrErrHrmrFr2r1rnrKrLrIrJ)r"rMr*rrr with_password7s   zURL.with_passwordcCs\t|ts td|std|std|j}t|jj||j |j ||j dddS)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 allowedrTr_) rGrErHrmrFr2r1rnrKrLrMrJ)r"r>r*rrr with_hostPs z URL.with_hostcCsb|durt|tstdt||std|j}t|jj | |j |j |j |dddS)z`Return a new URL with port replaced. Clear port to default if None is passed. Nz"port should be int or None, got {}z1port replacement is not allowed for relative URLsrTr_)rGintrHrgrDrmrFr2r1rnrKrLrMrI)r"rJr*rrr with_porthsz URL.with_portr_cCsZ|s||}|r||}t|dkr |ddkr d|}t|jj|dddddS)z$Return a new URL with path replaced.rrkrrTr_)r`rmrOrr1r2rn)r"r?r9rrr with_path{s  z URL.with_pathccsf|D]-\}}t|ttfr"|D]}||d|||Vqq||d|||VqdS)N=)rGlistr _query_var)rUrpairskeyr*rrrr_query_seq_pairss zURL._query_seq_pairscCs~t|}t|tr |St|tr(t|rtdt|r"tdtt|St|tr7|t ur7tt|St d ||)Nzfloat('inf') is not supportedzfloat('nan') is not supportedzMInvalid variable type: value should be str, int or float, got {!r} of type {}) rD issubclassrEfloatmathisinfrFisnanrrrHrg)rrUrrrrs      zURL._query_varcs|rt|dkr td|}nt|dkr|d}ntd|dur&d}|St|tr;jd|}|St|trG |}|St|t t t frSt dt|trjjdfdd|D}|St d ) Nrz7Either kwargs or single query parameter must be presentr r&zAInvalid query type: bytes, bytearray and memoryview are forbiddenc3s.|]\}}|d|VqdS)rN)rrkrrr"rrrs z%URL._get_str_query..zRInvalid query type: only str, mapping or sequence of (key, value) pairs is allowed)rrFrGr_QUERY_PART_QUOTERrritemsrErabytes bytearray memoryviewrHr)r"argskwargsrXrrr_get_str_querys@       zURL._get_str_querycOs,|j|i|}t|jj|jj|dddS)a[Return a new URL with query part replaced. Accepts any Mapping (e.g. dict, multidict.MultiDict instances) or str, autoencode the argument if needed. A sequence of (key, value) pairs is supported as well. It also can take an arbitrary number of keyword arguments. Clear query if None is passed. )r?rXTr_)rr1r2rnr?)r"rr new_queryrrrrcszURL.with_querycOsP|j|i|}tt|dd}t|j}||t|jj||dddS)z)Return a new URL with query part updated.Tr)rXr_)rr rrXupdater1r2rn)r"rrsrrXrrrrs   zURL.update_querycCsN|durd}nt|tstd||}|j|kr|St|jj|dddS)zReturn a new URL with fragment replaced. Autoencode fragment if needed. Clear fragment to default if None is passed. NrzInvalid fragment type)rYTr_)rGrErHrbrr1r2rn)r"rYrrrr with_fragments    zURL.with_fragmentcCst|ts tdd|vrtd||}|dvrtdt|j}|r.rFr)rr\rMr>rr?rrXrrYr rrZrKr2rJ)r"r\rMr>r?r]rYrrr human_repr*s2     zURL.human_repr)r)F)FTF)Zr rr/ __slots__rrrr`rNrarQrrbrRrrrrrT classmethodrfrhrprsrurxr{r~rrrrrrrrrrmrrrpropertyrZrrr[rr\rrMrr>rJrrr?rXrr]rrrrYrrrrr! staticmethodrPrOsys version_inforrKrrrrrrrrrrcrrrrrrrrrr1:sG      0E                                   (  r1cCsT|s|Sd|D]}||vr||dt|}q|r |Sddd|DS)Nrz%{:02X}rcss$|] }|r |nt|VqdSr$) isprintabler )rcrrrrPs"z_human_quote..)replacergordr r)rr8r rrrrHs rcCs6z t|dWSty|ddYSw)Nrtidna)rdecoder; UnicodeError)rrrrrVs  rcCs:z tj|dddWSty|ddYSw)NT)uts46rtr)rr;rr)r>rrrr^s  rcCsttdSr$)r cache_clearrrrrrrfs rcCsttdS)N)Z idna_encodeZ idna_decode)r cache_inforrrrrrlsrZidna_encode_sizeZidna_decode_sizecCs$t|tjat|tjadSr$) functools lru_cacher __wrapped__rrrrrcache_configuretsr)%rrrBcollections.abcrr ipaddressr urllib.parserrrrr r Z multidictr r rrZ_quotingrrrrSr0rrr1r _MAXCACHErrrrrrrrrrsH