
     f                        d dl Z d dlZd dlZd dlZd dlmZmZ d dlmZ d dl	m
Z
mZ d dlmZ d dlmZmZmZmZmZmZmZmZmZmZmZmZ d dlmZmZmZmZm Z m!Z!m"Z" d dl#Z#d dl$m%Z%m&Z&m'Z' d	d
l(m)Z) d	dl*m+Z+m,Z, ddddddZ- e.e!      Z/ e.e"      Z0 e.d      Z1 e2       Z3 ejh                  dejj                        Z6ee7e8e9f   Z:ee:df   Z;ede7ddf   Z< ed      Z=ej|                  dk\  rd dlm?Z? neZ? G d de      Z@ G d ded      ZA G d ded      ZBde=d e=fd!ZCd"d#d ee7   fd$ZDeC G d% d&             ZEd'ee7df   d(e7d ee7df   fd)ZFd*ZG eeG      d+e7d e7fd,       aH eeG      d-e7d e7fd.       aI eeG      d/e7d ee7e8f   fd0       aJ eeG      d-e7d dfd1       aKeCd:d2       ZLeCd e@fd3       ZMeCeGeGeGeGd4d5ee8df   d6ee8df   d7ee8df   d8ee8df   d df
d9       ZNy);    N)MappingSequence)suppress)
_CacheInfo	lru_cache)
ip_address)TYPE_CHECKINGAnyCallableIterableIteratorListSupportsIntTuple	TypedDictTypeVarUnionoverload)SplitResult	parse_qslquoteurlsplit
urlunsplituses_netlocuses_relative)	MultiDictMultiDictProxyistr   )cached_property)_Quoter	_UnquoterP   i     )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})
    zSequence[SimpleQuery]zMapping[str, QueryVariable]z#Sequence[Tuple[str, QueryVariable]]_T)      )Selfc                   :    e Zd ZU dZeed<   eed<   eed<   eed<   y)	CacheInfozHost encoding cache.idna_encodeidna_decoder   host_validateN)__name__
__module____qualname____doc__r   __annotations__     C/var/www/html/py/new-venv/lib/python3.12/site-packages/yarl/_url.pyr/   r/   N   s    r9   r/   c                   @    e Zd ZU eed<   eed<   eed<   eed<   eed<   y)_SplitResultDictschemenetlocpathqueryfragmentN)r3   r4   r5   strr7   r8   r9   r:   r<   r<   W   s    KK
IJMr9   r<   F)totalc                      e Zd ZU eed<   eed<   eed<   eedf   ed<   eedf   ed<   eed<   eedf   ed<   eedf   ed	<   eedf   ed
<   eedf   ed<   eedf   ed<   eedf   ed<   eedf   ed<   eedf   ed<   eed<   eed<   ee	eef      ed<   ded<   eed<   eed<   eed<   eed<   eed<   eed<   e	edf   ed<   e	edf   ed<   ded<   eed <   eed!<   eed"<   eed#<   e	edf   ed$<   e	edf   ed%<   y)&_InternalURLCacheabsoluter=   raw_authorityN_default_port_port_not_default	authorityraw_useruserraw_passwordpasswordraw_hosthostportexplicit_portraw_pathr?   _parsed_queryMultiDictProxy[str]r@   raw_query_stringquery_stringpath_qsraw_path_qsraw_fragmentrA   .	raw_partspartsURLparentraw_namename
raw_suffixsuffixraw_suffixessuffixes)
r3   r4   r5   boolr7   rB   r   intr   r   r8   r9   r:   rE   rE   `   sC   NKd##S$Y''NCI
T	
T	""CICI
T	

T	
d##M
Ic3h((  LMS#Xc?MM
IOKS/!CHor9   rE   objreturnc                     d| _         | S )Nyarl)r4   )rg   s    r:   rewrite_modulerk      s    CNJr9   segmentsSequence[str]c                     g }| D ]G  }|dk(  r)t        t              5  |j                          ddd       1|dk7  s7|j                  |       I | r| d   dv r|j                  d       |S # 1 sw Y   oxY w)z1Drop '.' and '..' from a sequence of str segments..N.rp   ro    )r   
IndexErrorpopappend)rl   resolved_pathsegs      r:   _normalize_path_segmentsry      s      "M &$; *% $!!#$ $CZ  %& HRLK/ 	R $ $s   A++A4	c                   
   e Zd ZU dZ ed      Z e       Z eddd      Z edd      Z edd	d
d      Z	 edd	d
      Z
 edd
d      Z edd      Z ed      Z e       Z ed      Z edd      Z ed
      Zeed<   	 dddddeeed f   dedeedf   defdZeddddddddddddded ed!eedf   d"eedf   d#ed$eedf   d%ed&eedf   d'ed(ededd fd)       Zd* Zdefd+Zdefd,Z de!fd-Z"d.e#defd/Z$defd0Z%d.e#defd1Z&d.e#defd2Z'd.e#defd3Z(d.e#defd4Z)d5edd fd6Z*d&edd fd7Z+defd8Z,de-e   fd9Z.d: Z/dd;Z0defd<Z1defd=Z2dd>Z3dd?Z4e5defd@       Z6e5defdA       Z7e5defdB       Z8e5deedf   fdC       Z9e5deedf   fdD       Z:e5defdE       Z;e5deedf   fdF       Z<e5deedf   fdG       Z=e5deedf   fdH       Z>e5deedf   fdI       Z?e5deedf   fdJ       Z@e5deedf   fdK       ZAe5deedf   fdL       ZBe5deedf   fdM       ZCe5deedf   fdN       ZDe5defdO       ZEe5defdP       ZFe5defdQ       ZGe5deHe-eef      fdR       ZIe5ddS       ZJe5defdT       ZKe5defdU       ZLe5defdV       ZMe5defdW       ZNe5defdX       ZOe5defdY       ZPe5de-edZf   fd[       ZQe5de-edZf   fd\       ZRe5dd]       ZSe5defd^       ZTe5defd_       ZUe5defd`       ZVe5defda       ZWe5de-edZf   fdb       ZXe5de-edZf   fdc       ZYeZd#ed%eddfdd       Z[ddedfdedd fdgZ\ed%edefdh       Z]e	 dd#ediedjedefdk       Z^e	 	 	 dd!eedf   d"eedf   d#eedf   d$eedf   dledmednedefdo       Z_ee`dpede-eedf   eedf   eedf   eedf   f   fdq              Zadedd fdrZbd!eedf   dd fdsZcd"eedf   dd fdtZdd#edd fduZed$eedf   dd fdvZfddwd%ededd fdxZgedyehegef   dzeie-eejf      deke   fd{       ZleZd|ejdefd}       Zmd~eie-eeenf   ef      defdZodepdepdeedf   fdZqerd&edd fd       Zserdejdd fd       Zsdepdepdd fdZserd&edd fd       Zterdejdd fd       Ztdepdepdd fdZterd&edd fd       Zuerdejdd fd       Zudepdepdd fdZudedd fdZvd(eedf   dd fdZwd5edd fdZxdedd fdZyddZzddwd.ededd fdZ{defdZ|y)r]   )_cache_valF)requotez@:z/+)safe	protectedr}   )r~   r   z?/:@z=+&;T)r~   r   qsr}   )r~   r   r   )r~   r   r}   )r~   r}   )r~   +)unsafez/%)ignorer   )r   r|   rs   N)encodedstrictvalr   r   rh   c                0   |t        j                  d       t        |      | u r|S t        |      t        u rt	        |      }nNt        |      t
        u r|s;t        d      t        |t              rt	        t        |            }nt        d      i }|s\|\  }}}}}	|sd}
n| j                  |d         \  }}}
}|
|t        v rd| d}t        |      d}
| j                  |
d	      }
|d n| j                  |      }|d n| j                  |      }| j                  |||
|d
      }d|
v r+|
j                  d      \  }}}|j                  d      \  }}}n|
}||d<   ||d<   ||d<   ||d<   |r$| j                  |      }|r| j!                  |      }| j#                  |
|       |r| j%                  |      n|}|	r| j'                  |	      n|	}	||d<   ||d<   |	|d<   t        |||||	      }t(        j+                  |       }||_        ||_        |S )Nzstrict parameter is ignoredz$Cannot apply decoding to SplitResultz#Constructor parameter should be strrs   r   z9Invalid URL: host is required for absolute urls with the  schemeFvalidate_hostencode_host[]rO   rK   rM   rR   rP   r?   r=   rV   rZ   )warningswarntyperB   r   r   
ValueError
isinstance	TypeError_split_netlocSCHEME_REQUIRES_HOST_encode_host	_REQUOTER_make_netloc	partition_PATH_REQUOTER_normalize_path _validate_authority_uri_abs_path_QUERY_REQUOTER_FRAGMENT_REQUOTERobject__new__r|   r{   )clsr   r   r   cacher=   r>   r?   r@   rA   rP   usernamerN   rQ   msgrK   rM   _	bracketedrO   selfs                        r:   r   zURL.__new__   sb    MM789J93-C#Y+% !GHHS!3s8$CABB#%471FFD%141B1B3q61J.(D$<!5566<XWF  )o-!''E'B#+#34x9P'/'7tS]]8=T))lD$E *  $; '+nnS&9OAq)%.%8%8%=NHa#H$,j!$,j!(4n%)-o&))$/..t4D00d0F27C''.UE;Cs--h7H$E(O(-E$%$,E.!ffdE8DC~~c"	r9   )r=   rJ   rL   rN   rP   rQ   r?   r@   rW   rA   r   r=   rJ   rL   rN   rP   rQ   r?   r@   rW   rA   c          	      \   |r|s|s|s|rt        d      t        |t        t        d      f      st	        d      |r|st        d      |r|	rt        d      |
||||	|
t	        d      |rf|r|}n| j                  |      \  }}}}|t        j                  |      k(  rdn|}|dn| j                  |d	      }| j                  ||||d
d      }n@|s	|s|s|sd}n5|t        j                  |      k(  rdn|}| j                  ||||| |       }|sg|r| j                  |      n|}|r|r| j                  |      }| j                  ||       |	r| j                  |	      n|	}	|
r| j                  |
      n|
}
 | t        ||||	|
      d
      }|r|j!                  |      S |S )zCreates and returns a new URLz@Can't mix "authority" with "user", "password", "host" or "port".NzThe 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.rs   Fr   T)encoder   r   r   )r   r   rf   r   r   r   DEFAULT_PORTSgetr   r   _PATH_QUOTERr   r   _QUERY_QUOTER_FRAGMENT_QUOTERr   
with_query)r   r=   rJ   rL   rN   rP   rQ   r?   r@   rW   rA   r   r>   _user	_password_host_porturls                     r:   buildz	URL.buildF  s   $ $(ddS  $d4j 12=>>OPP\UVVN ||#Q 
 "141B1B91M.y%$(9(9&(AAtu } ))%u)E 
 ))9eT$E *  htDF=#4#4V#<<4$D%%hdw;PWK & F -13##D)tD**4000d0F3?!!,/\  :Bs++H5xHlHEt
 >>%((
r9   c                      t        d| d      )NzInheriting a class z from URL is forbidden)r   )r   s    r:   __init_subclass__zURL.__init_subclass__  s    -cW4JKLLr9   c           	      X   | j                   }|j                  s6| j                  r*|j                  s|j                  r|j                  d      }| j                  x}D|j                  | j                  | j                  | j                  | j                  |d            }t        |      S )N/r?   Fr   r>   )r|   r?   rF   r@   rA   _replacerI   r   rK   rM   host_subcomponentr   )r   r   rQ   s      r:   __str__zURL.__str__  s    iixxDMMsyyCLL,,C,(C***D3 ,,((MM%%** % )   C #r9   c                 L    | j                   j                   dt        |        dS )Nz('z'))	__class__r3   rB   r   s    r:   __repr__zURL.__repr__  s$    ..))*"SYKr::r9   c                 6    t        |       j                  d      S )Nascii)rB   r   r   s    r:   	__bytes__zURL.__bytes__  s    4y((r9   otherc                    t        |      t        urt        S | j                  }|j                  s| j
                  r|j                  d      }|j                  }|j                  s|j
                  r|j                  d      }||k(  S )Nr   r   )r   r]   NotImplementedr|   r?   rF   r   )r   r   val1val2s       r:   __eq__z
URL.__eq__  sj    ;c!!!yyyyT]]==c=*DzzyyU^^==c=*Dt|r9   c                     | j                   j                  d      }|P| j                  }|j                  s| j                  r|j                  d      }t        |      x}| j                   d<   |S )Nhashr   r   )r{   r   r|   r?   rF   r   r   )r   retr   s      r:   __hash__zURL.__hash__  s[    kkoof%;))C88lll,(,S	1C$++f%
r9   c                 b    t        |      t        urt        S | j                  |j                  k  S Nr   r]   r   r|   r   r   s     r:   __le__z
URL.__le__  '    ;c!!!yyEJJ&&r9   c                 b    t        |      t        urt        S | j                  |j                  k  S r   r   r   s     r:   __lt__z
URL.__lt__  '    ;c!!!yy5::%%r9   c                 b    t        |      t        urt        S | j                  |j                  k\  S r   r   r   s     r:   __ge__z
URL.__ge__  r   r9   c                 b    t        |      t        urt        S | j                  |j                  kD  S r   r   r   s     r:   __gt__z
URL.__gt__  r   r9   r`   c                 d    t        |t              st        S | j                  t        |      f      S r   )r   rB   r   _make_childr   r`   s     r:   __truediv__zURL.__truediv__  s)    $$!!T--r9   c                 $    | j                  |      S r   )update_queryr   r@   s     r:   __mod__zURL.__mod__  s      ''r9   c                     t        | j                  j                  xsF | j                  j                  xs. | j                  j                  xs | j                  j
                        S r   )re   r|   r>   r?   r@   rA   r   s    r:   __bool__zURL.__bool__  sE    IIW		W$))//WTYYEWEW
 	
r9   c                     | j                   fS r   )r|   r   s    r:   __getstate__zURL.__getstate__  s    		|r9   c                 ~    |d   (t        |d   t              r|d   d   | _        i | _        y |^| _        }i | _        y )Nr   r   r|   )r   dictr|   r{   )r   stateunuseds      r:   __setstate__zURL.__setstate__  sG    8
58T :a(DI  "'DIr9   c                     | j                   }| j                  | j                  j                        \  |d<   |d<   |d<   |d<   y)z"Cache the netloc parts of the URL.rK   rM   rO   rR   N)r{   r   r|   r>   )r   r   s     r:   _cache_netloczURL._cache_netloc  sJ     tyy//0	
*.!*/"r9   c                     | j                   S )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.
        )rF   r   s    r:   is_absolutezURL.is_absolute  s     }}r9   c                 H    | j                   }| j                  }||duS ||k(  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.

        N)rH   rR   )r   defaultexplicits      r:   is_default_portzURL.is_default_port
  s6     $$%%$&&7""r9   c                    | j                   st        d      | j                  j                  st        d      | j                  }| j	                  dd|j
                  |j                        }|j                  |ddd      }t        |d      S )z}Return an URL with scheme, host and port parts only.

        user, password, path, query and fragment are removed.

        URL should be absolutezURL should have schemeNrs   )r>   r?   r@   rA   Tr   )	rF   r   r|   r=   r   hostnamerQ   r   r]   )r   vr>   r   s       r:   originz
URL.origin  sz     }}566yy566II""4qzz166BjjRrBjG3%%r9   c                     | j                   st        d      | j                  j                  dd      }t	        |d      S )zhReturn a relative part of the URL.

        scheme, user, password, host and port are removed.

        r   rs   )r=   r>   Tr   )rF   r   r|   r   r]   )r   r   s     r:   relativezURL.relative+  s=     }}566ii  2 63%%r9   c                 4    | j                   j                  dk7  S )zA check for absolute URLs.

        Return True for absolute ones (having scheme or starting
        with //), False otherwise.

        rs   r|   r>   r   s    r:   rF   zURL.absolute6  s     yy2%%r9   c                 .    | j                   j                  S )zdScheme for absolute URLs.

        Empty string for relative URLs or URLs starting with //

        )r|   r=   r   s    r:   r=   z
URL.schemeD       yyr9   c                 .    | j                   j                  S )zQEncoded authority part of URL.

        Empty string for relative URLs.

        r  r   s    r:   rG   zURL.raw_authorityM  r  r9   c                 @    t         j                  | j                        S )z1Default port for the scheme or None if not known.)r   r   r=   r   s    r:   rH   zURL._default_portV  s       --r9   c                 >    | j                   }| j                  |k(  ry|S )z@The port part of URL normalized to None if its the default port.N)rQ   rH   )r   rQ   s     r:   rI   zURL._port_not_default[  s#     yy%r9   c                 ~    | j                  | j                  | j                  | j                  | j                  d      S )zQDecoded authority part of URL.

        Empty string for relative URLs.

        Fr   )r   rL   rN   rP   rQ   r   s    r:   rJ   zURL.authorityc  s7       IIt}}dii ! 
 	
r9   c                 @    | j                          | j                  d   S )zEEncoded user part of URL.

        None if user is missing.

        rK   r   r{   r   s    r:   rK   zURL.raw_usern  s     	{{:&&r9   c                 B    | j                   }|y| j                  |      S )zEDecoded user part of URL.

        None if user is missing.

        N)rK   	_UNQUOTER)r   rK   s     r:   rL   zURL.usery  s%     ==~~h''r9   c                 @    | j                          | j                  d   S )zMEncoded password part of URL.

        None if password is missing.

        rM   r	  r   s    r:   rM   zURL.raw_password  s     	{{>**r9   c                 B    | j                   }|y| j                  |      S )zMDecoded password part of URL.

        None if password is missing.

        N)rM   r  )r   rM   s     r:   rN   zURL.password  s'     ((~~l++r9   c                 @    | j                          | j                  d   S )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.
        rO   r	  r   s    r:   rO   zURL.raw_host  s     	{{:&&r9   c                 l    | j                   x}y|r|d   j                         sd|v r|S t        |      S )zDDecoded host part of URL.

        None for relative URLs.

        Nrq   :)rO   isdigit_idna_decoder   raws     r:   rP   zURL.host  s<     == C)3r7??$s
JC  r9   c                 8    | j                   x}yd|v rd| dS |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   r   )rO   r  s     r:   r   zURL.host_subcomponent  s/    $ == C) CZ3%qz0S0r9   c                 6    | j                   xs | j                  S )zPort part of URL, with scheme-based fallback.

        None for relative URLs or URLs without explicit port and
        scheme without default port substitution.

        )rR   rH   r   s    r:   rQ   zURL.port  s     !!7T%7%77r9   c                 @    | j                          | j                  d   S )zyPort part of URL, without scheme-based fallback.

        None for relative URLs or URLs without explicit port.

        rR   r	  r   s    r:   rR   zURL.explicit_port  s     	{{?++r9   c                 R    | j                   j                  }|s| j                  rd}|S )zNEncoded path of URL.

        / for absolute URLs without path part.

        r   )r|   r?   rF   )r   r   s     r:   rS   zURL.raw_path  s$     iinnt}}C
r9   c                 8    | j                  | j                        S )zNDecoded path of URL.

        / for absolute URLs without path part.

        )_PATH_UNQUOTERrS   r   s    r:   r?   zURL.path  s     ""4==11r9   c                 8    | j                  | j                        S )z{Decoded path of URL.

        / for absolute URLs without path part.

        / (%2F) and % (%25) are not decoded

        )_PATH_SAFE_UNQUOTERrS   r   s    r:   	path_safezURL.path_safe  s     ''66r9   c                 0    t        | j                  d      S )zParse query part of URL.Tkeep_blank_values)r   rV   r   s    r:   rT   zURL._parsed_query  s     ..$GGr9   c                 >    t        t        | j                              S )zA MultiDictProxy representing parsed query parameters in decoded
        representation.

        Empty value if URL has no query part.

        )r   r   rT   r   s    r:   r@   z	URL.query  s     i(:(:;<<r9   c                 .    | j                   j                  S )zOEncoded query part of URL.

        Empty string if query is missing.

        )r|   r@   r   s    r:   rV   zURL.raw_query_string  s     yyr9   c                 8    | j                  | j                        S )zODecoded query part of URL.

        Empty string if query is missing.

        )_QS_UNQUOTERrV   r   s    r:   rW   zURL.query_string  s       !6!677r9   c                 h    | j                   s| j                  S | j                   d| j                    S )zDecoded path of URL with query.?)rW   r?   r   s    r:   rX   zURL.path_qs"  s3       99))Ad//011r9   c                 h    | j                   s| j                  S | j                   d| j                    S )zEncoded path of URL with query.r&  )rV   rS   r   s    r:   rY   zURL.raw_path_qs)  s3     $$== --$"7"7!899r9   c                 .    | j                   j                  S )zUEncoded fragment part of URL.

        Empty string if fragment is missing.

        )r|   rA   r   s    r:   rZ   zURL.raw_fragment0  s     yy!!!r9   c                 8    | j                  | j                        S )zUDecoded fragment part of URL.

        Empty string if fragment is missing.

        )r  rZ   r   s    r:   rA   zURL.fragment9  s     ~~d//00r9   .c                 >   | j                   j                  }| j                  r3|sdg}t	        |      S dg|dd j                  d      z   }t	        |      S |r+|d   dk(  r#dg|dd j                  d      z   }t	        |      S |j                  d      }t	        |      S )zjA tuple containing encoded *path* parts.

        ('/',) for absolute URLs if *path* is missing.

        r   r   Nr   )r|   r?   rF   splittuple)r   r?   r\   s      r:   r[   zURL.raw_partsB  s     yy~~== U| QRs 33 U|	 Q3QRs 33 U| 

3U|r9   c                 @     t         fd j                  D              S )zjA tuple containing decoded *path* parts.

        ('/',) for absolute URLs if *path* is missing.

        c              3   @   K   | ]  }j                  |        y wr   r  ).0partr   s     r:   	<genexpr>zURL.parts.<locals>.<genexpr>]  s     EdT^^D)E   )r,  r[   r   s   `r:   r\   z	URL.partsV  s     EdnnEEEr9   c                 H   | j                   }|r|dk(  rB| j                  s| j                  r(t        | j                  j                  dd      d      S | S |j                  d      }| j                  j                  dj                  |dd       dd      }t        |d      S )	z]A new URL with last part of path removed and cleaned up query and
        fragment.

        r   rs   )r@   rA   Tr   Nrq   r?   r@   rA   )rS   rZ   rV   r]   r|   r   r+  join)r   r?   r\   r   s       r:   r^   z
URL.parent_  s     }}ts{  D$9$9499--B-DdSSK

3ii  chhuSbz&:"r R3%%r9   c                 V    | j                   }| j                  r|dd }|sy|d   S |d   S )zThe last part of raw_parts.r   Nrs   rq   )r[   rF   )r   r\   s     r:   r_   zURL.raw_namen  s9     ==!"IERy 9r9   c                 8    | j                  | j                        S )zThe last part of parts.)r  r_   r   s    r:   r`   zURL.name{  s     ~~dmm,,r9   c                 |    | j                   }|j                  d      }d|cxk  rt        |      dz
  k  rn y||d  S y)Nrp   r   r   rs   )r_   rfindlen)r   r`   is      r:   ra   zURL.raw_suffix  sB    }}JJsOq 3t9q=   8Or9   c                 8    | j                  | j                        S r   )r  ra   r   s    r:   rb   z
URL.suffix  s    ~~doo..r9   c                     | j                   }|j                  d      ry|j                  d      }t        d |j	                  d      dd  D              S )Nrp   r8   c              3   &   K   | ]	  }d |z     yw)rp   Nr8   )r0  rb   s     r:   r2  z#URL.raw_suffixes.<locals>.<genexpr>  s     DfS6\Ds   r   )r_   endswithlstripr,  r+  r   s     r:   rc   zURL.raw_suffixes  sH    }}=={{3D

30CDDDr9   c                 @     t         fd j                  D              S )Nc              3   @   K   | ]  }j                  |        y wr   r/  )r0  rb   r   s     r:   r2  zURL.suffixes.<locals>.<genexpr>  s     LT^^F+Lr3  )r,  rc   r   s   `r:   rd   zURL.suffixes  s    L$:K:KLLLr9   c                 6    | r|r|d   dk(  st        d      yyy)znEnsure that path in URL with authority starts with a leading slash.

        Raise ValueError if not.
        r   r   zCPath in a URL with authority should start with a slash ('/') if setN)r   r   s     r:   r   z$URL._validate_authority_uri_abs_path  s,     DaCU  "0D4r9   pathsrm   c                    g }t        t        |            D ]y  \  }}|dk(  }|r|d   dk(  rt        d|d      |r|n| j                  |      }t	        t        |j                  d                  }t        | xr |d   dk(        }|||d z  }{ |j                          | j                  j                  r<| j                  j                  j                  d      x}	r|	d   dk(  rdnd}
g |	d|
 |}| j                  rt        |      }|r|d   dk7  rdg|}dj                  |      }t        | j                  j                  |dd      d	
      S )z
        add paths to self._val.path, accounting for absolute vs relative paths,
        keep existing, but do not create new, empty segments
        r   r   zAppending path z! starting from slash is forbiddenrs   Nrq   r5  Tr   )	enumeratereversedr   r   listr+  rf   reverser|   r?   rF   ry   r6  r]   r   )r   rE  r   parsedidxr?   lastrl   segment_slice_startold_path_segmentsold_path_cutoffnew_paths               r:   r   zURL._make_child  sq   
 "8E?3 	5IC!8DQ3 %dX-NO  #4(9(9$(?DHTZZ_56H"%$h&D8A;"3D"Eh2344F	5 	99>>DIINN4H4H4MM0M$5b$9R$?bTOD()9/:DVDF==-f5F&)r/ v88F#IIHBDd
 	
r9   c                     d|vr|S d}|r|d   dk(  rd}|dd  }|j                  d      }|dj                  t        |            z   S )Nrp   rs   r   r   r   )r+  r6  ry   )r   r?   prefixrl   s       r:   r   zURL._normalize_path  s[     d?KDGsN F8D::c?!9(!CDDDr9   humanr   c                 ^   d|v r|j                  d      \  }}}n|}dx}}|r|d   j                         sd|v r(	 t        |      }|\  }}|r|d|z   z  }|dk(  rd| dS |S |j	                         }|r|S |j                         r|rt        |       |S t        |      S # t        $ r Y Iw xY w)N%rs   rq   r     r   r   )r   r  _ip_compressed_versionr   lowerisascii_host_validate_idna_encode)	r   rP   rT  r   raw_ipsepzoneip_compressed_versionversions	            r:   r   zURL._encode_host  s     $; $s 3FCFOC$fRj((*cVm$(>v(F% !6gC$J&Da<tfA;&zz|K <<> t$KD!!5  s   B   	B,+B,r   r   r}   c                     |y|r| j                   n| j                  }|r| j                  |      }	n|}	||	 d| }	|"|sd}n
|r ||      }|r ||      }|dz   |z   }n|r
|r ||      }|r|dz   |	z   }	|	S )Nrs   r  @)r   _QUOTERr   )
r   rL   rN   rP   rQ   r   r   r}   quoterr   s
             r:   r   zURL._make_netloc  s     <")s{{""4(CCE4&/C!$<D!(+#:(Df$<D*s"C
r9   r>   c                    d|vrd}d}|}n.|j                  d      \  }}}|j                  d      \  }}}|sd}d|v r@|j                  d      \  }}}|j                  d      \  }	}}
|
j                  d      \  }}}
n|j                  d      \  }	}}
|
sd}n.	 t        |
      }d|cxk  rdk  st        d	       t        d	      |xs d||	xs d|fS # t        $ r t        d      w xY w)
z4Split netloc into username, password, host and port.rc  Nr  r   r   z/Invalid URL: port can't be converted to integerr     zPort out of range 0-65535)
rpartitionr   rf   r   )r   r>   r   rN   hostinfouserinfor   have_passwordr   r   port_strrQ   s               r:   r   zURL._split_netloc5  s-    f)-H)-HH$*$5$5c$:!Ha080B0B30G-HmX (?&005OAq)$-$7$7$<!Ha%//4NAq($,$6$6s$;!Ha%)DT8} && !<== ' !<==48+;tTAA  T !RSSTs   C C)c                     t        |t              st        d      | j                  s|t        v rd| d}t        |      t        | j                  j                  |j                               d      S )z&Return a new URL with scheme replaced.zInvalid scheme typez<scheme replacement is not allowed for relative URLs for the r   r=   Tr   )
r   rB   r   rF   r   r   r]   r|   r   rY  )r   r=   r   s      r:   with_schemezURL.with_schemeY  sp     &#&122}}+?!?))/9  S/!499%%V\\^%<dKKr9   c           
      ^   | j                   }|d}n9t        |t              r| j                  |      }|j                  }nt        d      | j                  st        d      t        | j                   j                  | j                  |||j                  |j                              d      S )zReturn a new URL with user replaced.

        Autoencode user if needed.

        Clear user/password if user is None.

        NzInvalid user typez1user replacement is not allowed for relative URLsr   Tr   )r|   r   rB   rd  rN   r   rF   r   r]   r   r   r   rQ   )r   rL   r   rN   s       r:   	with_userzURL.with_userf  s     ii<Hc"<<%D||H/00}}PQQII((xsxxP   	
 	
r9   c           
      V   |n-t        |t              r| j                  |      }nt        d      | j                  st        d      | j                  }t        | j                  j                  | j                  |j                  ||j                  |j                              d      S )zReturn a new URL with password replaced.

        Autoencode password if needed.

        Clear password if argument is None.

        zInvalid password typez5password replacement is not allowed for relative URLsr   Tr   )r   rB   rd  r   rF   r   r|   r]   r   r   r   r   rQ   )r   rN   r   s      r:   with_passwordzURL.with_password  s     #&||H-H344}}TUUiiII((xsxxX   	
 	
r9   c           
      F   t        |t              st        d      | j                  st	        d      |st	        d      | j
                  }t        | j
                  j                  | j                  |j                  |j                  ||j                              d      S )zReturn a new URL with host replaced.

        Autoencode host if needed.

        Changing host for relative URLs is not allowed, use .join()
        instead.

        zInvalid host typez1host replacement is not allowed for relative URLszhost removing is not allowedr   Tr   )r   rB   r   rF   r   r|   r]   r   r   r   rN   rQ   )r   rP   r   s      r:   	with_hostzURL.with_host  s     $$/00}}PQQ;<<iiII((s||T388T   	
 	
r9   c           
         |Ot        |t              st        |t              st        dt	        |             |dk  s|dkD  rt        d|       | j                  st        d      | j                  }t        | j                  j                  | j                  |j                  |j                  |j                  |            d      S )	z`Return a new URL with port replaced.

        Clear port to default if None is passed.

        z port should be int or None, got r   rg  z&port must be between 0 and 65535, got z1port replacement is not allowed for relative URLsr   Tr   )r   re   rf   r   r   r   rF   r|   r]   r   r   r   rN   r   )r   rQ   r   s      r:   	with_portzURL.with_port  s     $%Zc-B"B4:, OPPax4%< #I$!PQQ}}PQQiiII((s||S\\SWX   	
 	
r9   r   c                    |s.| j                  |      }| j                  r| j                  |      }t        |      dkD  r|d   dk7  rd|z   }t	        | j
                  j                  |dd      d      S )z$Return a new URL with path replaced.r   r   rs   r5  Tr   )r   rF   r   r;  r]   r|   r   )r   r?   r   s      r:   	with_pathzURL.with_path  sn    $$T*D}}++D1t9q=T!W^:D499%%4rB%GQUVVr9   re  pairsc              #      K   |D ]m  \  }}t        |t        t        f      r-|D ]'  } ||      dz    || j                  |            z    ) I ||      dz    || j                  |            z    o y w)N=)r   rI  r,  
_query_var)r   re  rz  keyr   r   s         r:   _query_seq_pairszURL._query_seq_pairs  s       	FHC#e}- HA ++fS^^A5F.GGGH SkC'&1D*EEE	Fs   A4A6r   c                    t        |       }|t        u st        |t              rt        rt	        | t              sJ | S t        |t
              rlt        rt	        | t
              sJ t        j                  |       rt        d      t        j                  |       rt        d      t        t        |             S |t        ur$t	        |t              rt        t        |             S t        dj                  | |            )Nzfloat('inf') is not supportedzfloat('nan') is not supportedzMInvalid variable type: value should be str, int or float, got {!r} of type {})r   rB   
issubclassr	   r   floatmathisinfr   isnanre   r   rf   r   format)r   r   s     r:   r}  zURL._query_var  s    1g#:C-!!S)))Hc5!!!U+++zz!} !@AAzz!} !@AAuQx= d?z#{;s1v;3
 	
r9   itemsc                     | j                   }dj                  |D cg c]'  \  }} ||       d || j                  |             ) c}}      S c c}}w )z'Return a query string from an iterable.&r|  )_QUERY_PART_QUOTERr6  r}  )r   r  re  kr   s        r:   _get_str_query_from_iterablez URL._get_str_query_from_iterable  sQ     (( xxQVWAF1I;atq/A(B'CDWXXWs   ,A
argskwargsc                    |rt        |      dkD  rt        d      |}nt        |      dk(  r|d   }nt        d      |y t        |t              r;| j                  }dj                  | j                  ||j                                     S t        |t              r| j                  |      S t        |t        t        t        f      rt        d      t        |t              r| j                  |      S t        d      )Nr   z7Either kwargs or single query parameter must be presentr   r  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   r  r6  r  r  rB   r   bytes	bytearray
memoryviewr   r   r  )r   r  r  r@   re  s        r:   _get_str_queryzURL._get_str_query  s    4y1} M  EY!^GEVWW=eW%,,F88D11&%++-HIIeS!%%e,,eeY
;<S  eX&
 44U;;8
 	
r9   c                      y r   r8   r   s     r:   r   zURL.with_query   s    14r9   c                      y r   r8   r   r  s     r:   r   zURL.with_query#  s    <?r9   c                 |     | j                   |i |xs d}t        | j                  j                  |      d      S )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.

        rs   r@   Tr   )r  r]   r|   r   )r   r  r  	new_querys       r:   r   zURL.with_query&  s?     (D''88>B	499%%I%6EEr9   c                      y r   r8   r   s     r:   extend_queryzURL.extend_query8      36r9   c                      y r   r8   r  s     r:   r  zURL.extend_query;      >Ar9   c                      | j                   |i |}|s| S | j                  x}r|d   dk(  r| | }n
| d| }n|}t        | j                  j	                  |      d      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')
        rq   r  r  Tr   )r  rV   r]   r|   r   )r   r  r  new_query_stringcurrent_querycombined_querys         r:   r  zURL.extend_query>  s     /4..??K 111=1 R C'$1?3C2D!E$1?!4D3E!F-N499%%N%;TJJr9   c                      y r   r8   r   s     r:   r   zURL.update_queryV  r  r9   c                      y r   r8   r  s     r:   r   zURL.update_queryY  r  r9   c                 f    | j                   |i |}|'t        | j                  j                  d      d      S t	        | j
                        }|j                  t        |d             | j                  |j                               }t        | j                  j                  |      d      S )a  Return 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')
        rs   r  Tr   r  )
r  r]   r|   r   r   rT   updater   r  r  )r   r  r  sr@   new_strs         r:   r   zURL.update_query\  s      D009tyy)))3TBB$,,-YqD9:33EKKMB499%%G%4dCCr9   query_paramsc                     t        |      | j                  j                         z  s| S | j                  t	        fd| j                  j                         D                    S )z4Remove some keys from query part and return new URL.c              3   4   K   | ]  \  }}|vr||f  y wr   r8   )r0  r`   valueparams_to_removes      r:   r2  z+URL.without_query_params.<locals>.<genexpr>u  s*      D%// us   )setr@   keysr   r,  r  )r   r  r  s     @r:   without_query_paramszURL.without_query_paramso  sY    |,tzz/@@K #'::#3#3#5 
 	
r9   c                     |d}n,t        |t              st        d      | j                  |      }| j                  |k(  r| S t        | j                  j                  |      d      S )zReturn a new URL with fragment replaced.

        Autoencode fragment if needed.

        Clear fragment to default if None is passed.

        rs   zInvalid fragment type)rA   Tr   )r   rB   r   r   rZ   r]   r|   r   )r   rA   rZ   s      r:   with_fragmentzURL.with_fragment|  sg     LHc*34400:L,K499%%|%<dKKr9   c                    t        |t              st        d      d|v rt        d      | j	                  |      }|dv rt        d      t        | j                        }| j                  r+t        |      dk(  r|j                  |       n||d<   d|d	<   n||d<   |d	   dk(  rd|d	<   t        | j                  j                  dj                  |      dd
      d      S )zReturn a new URL with name (last part of path) replaced.

        Query and fragment parts are cleaned up.

        Name is encoded if needed.

        zInvalid name typer   zSlash in name is not allowedrr   z. and .. values are forbiddenr   rq   rs   r   r5  Tr   )r   rB   r   r   r   rI  r[   rF   r;  rv   r]   r|   r   r6  )r   r`   r\   s      r:   	with_namezURL.with_name  s     $$/00$;;<<  &;<==T^^$==5zQT" b	E!HE"IQx3aIICHHUO2K
 	
r9   rb   c                    t        |t              st        d      |r|d   dk(  r|dk(  rt        d|      | j                  }|st        | d      | j
                  }|s||z   }n|dt        |        |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.
        zInvalid suffix typer   rp   zInvalid suffix z has an empty nameN)r   rB   r   r   r_   ra   r;  r  )r   rb   r`   
old_suffixs       r:   with_suffixzURL.with_suffix  s     &#&122&)s*fmvj9::}}x'9:;;__
&=D*3z?*+f4D~~d##r9   c                    t        |      t        urt        d      | j                  }|j                  }|j                  xs |j                  }||j                  k7  s|t
        vr|S |j                  r%|t        v rt        |j                  |      d      S d|i}|j                  s|j                  r|j                  |d<   |j                  s|j                  r|j                  |d<   |j                  st         |j                  di |d      S |j                  d   d	k(  r|j                  }n|j                  sd	|j                   }nu|j                  d
   d	k(  r|j                   |j                   }nHd	j                  g | j                  dd
 d      }||j                  z  }|j                  d   d	k(  r|dd }| j                  |      |d<   t         |j                  di |d      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.

        zurl should be URLrn  Tr   r=   rA   r@   r   r   rq   Nrs   r   r?   r8   )r   r]   r   r|   r=   USES_RELATIVEr>   USES_AUTHORITYr   r?   rA   r@   r6  r\   r   )r   r   r   	other_valr=   r\   r?   s          r:   r6  zURL.join  s    9C/00iiHH	!!/SZZSZZ6#>J . 8y)))8$GG#+V"4>>Y// ) 2 2E*>>Y__&__E'N~~|s||,e,d;;>>!#>>Dy~~&'DXXb\S hhZ	/0D
 882djj"o2r23DINN"Dxx{c!ABx,,T2f<3<<(%($77r9   c                (    | j                  ||      S )zAReturn a new URL with the elements in other appended to the path.r   )r   )r   r   r   s      r:   joinpathzURL.joinpath  s    w77r9   c                    t        | j                  d      }t        | j                  d      }| j                  }|r| j	                  |d      }t        | j
                  d      }t        r|J dj                  d | j                  j                         D              }t        | j                  d      }t        r|J | j                  |||| j                  d	      }t        | j                  ||||      }t        |      S )
z<Return decoded human readable string for URL representation.z#/:?@[]T)rT  z#?r  c              3   n   K   | ]-  \  }}d j                  t        |d      t        |d             / yw)z{}={}z#&+;=N)r  _human_quote)r0  r  r   s      r:   r2  z!URL.human_repr.<locals>.<genexpr>  s5       
1 NN<73\!W5MN 
s   35rs   Fr   )r  rL   rN   rP   r   r?   r	   r6  r@   r  rA   r   rR   r   r=   r   )	r   rL   rN   rP   r?   rW   rA   r>   r   s	            r:   
human_reprzURL.human_repr  s    DIIy1y9yy$$T$6DDIIt,###xx  


((* 
 
  r2'''""(D$"4"4% # 
 $++vt\8L#r9   )rs   rh   N)rh   r]   )rh   rU   )F)FT)FTF)r   r]   rh   r]   )}r3   r4   r5   	__slots__r!   rd  r   r   r   r   r   r  r   r   r"   r  r  r  r$  r   r7   r   rB   re   r-   r   classmethodrf   Queryr   r   r   r   r  r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r    rF   r=   rG   rH   rI   rJ   rK   rL   rM   rN   rO   rP   r   rQ   rR   rS   r?   r  r   rT   r@   rV   rW   rX   rY   rZ   rA   r[   r\   r^   r_   r`   ra   rb   rc   rd   staticmethodr   r   r   r   r   r   r   ro  rq  rs  ru  rw  ry  r   r   QueryVariabler   r  r}  r   r  r
   r  r   r   r  r   r  r  r  r  r6  r  r  r8   r9   r:   r]   r]      s   N #Ie$G	IeDL$$7N6dERM6VEO fuEFE: f-Ic*N#4<%L
 /1H $(H3U*+H 	H
 dDj!H 
HT  !%%)!%$(N N 	N
 CIN T	"N N CIN N UD[!N N N N 
N N`M $;# ;)5 )F t # 'F 't '
&F &t &
'F 't '
&F &t &
. . .
(U (u (
$ 

eK0 1	T 	# #"& 	& &$ & &        s     .uS$Y/ . . 5d#3   
3 
 
 '%T	* ' ' 	(eCI& 	( 	( +eCI. + + 	,%T	* 	, 	, '%T	* ' ' !eCI& ! ! 15d#3 1 1* 8eCI& 8 8 ,uS$Y/ , , 	# 	 	 2c 2 2 73 7 7 HtE#s(O4 H H = = #   8c 8 8 2 2 2 :S : : "c " " 1# 1 1 5c?  & FuS#X F F & & 
# 
 
 -c - - C   / / / EeCHo E E M%S/ M M s # $  !
 !
4 !
E !
F E3 E3 E E  CG7"7"#7"<@7"	7" 7"r    CI  T	"  CI	 
 CI        
   D  B B 
uS$YsDy!15d3CU3PT9EUU	V B   BDL# L% L
eCI. 
5 
4
eCI&6 
5 
2
c 
e 
0
eCI. 
5 
, 7< Wc Wt W W FseSj)F2:5mAS;T2UF	#F F 
m 
 
 
,YeE#t)$4c$9:;Y	Y"
C "
3 "
5d;K "
H 44%4 4?=?U? ?F Fs Fu F$ 6%6E6 6A]AuA AK# K K K0 6%6E6 6A]AuA AD# D D D&
# 
% 
LeCI&6 L5 L&
c 
e 
@$# $% $*38j 5: 8s 8T 8e 8C r9   r]   r  r   c                     | s| S d|z   D ]&  }|| v s| j                  |dt        |      d      } ( | j                         r| S dj                  d | D              S )NrV  02Xrs   c              3   V   K   | ]!  }|j                         r|n
t        |       # y wr   )isprintabler   )r0  cs     r:   r2  z_human_quote.<locals>.<genexpr>  s!     A!1U1X5As   '))replaceordr  r6  )r  r   r  s      r:   r  r    sf    6\ /6		!qQ-.A/ 	}}77AqAAAr9      r  c                     	 t        j                  | j                  d            S # t        $ r# | j                  d      j                  d      cY S w xY w)Nr   idna)r  decoder   UnicodeError)r  s    r:   r  r  #  sH    2{{3::g.// 2zz'"))&112s   #& )AArP   c                     	 t        j                  | d      j                  d      S # t        $ r# | j                  d      j                  d      cY S w xY w)NT)uts46r   r  )r  r   r  r  )rP   s    r:   r\  r\  +  sL    3{{4t,33G<< 3{{6"))'223s   %( )AAr]  c                 H    t        |       }|j                  |j                  fS )z8Return compressed version of IP address and its version.)r   
compressedra  )r]  ips     r:   rX  rX  3  s!     
F	B=="**$$r9   c           
          t         j                  |       }|y|j                         |j                         d}}}|dk(  s|dk(  r	d| |d v rd}t	        d| d|d| d	|       d)
zValidate an ascii host name.Nrs   rc  r  zQ, if the value includes a username or password, use 'authority' instead of 'host'zHost z cannot contain z (at position ))_not_reg_namesearchgroupstartr   )rP   invalidr  posextras        r:   r[  r[  :  s     ""4(G"3E|ST
):0 	 
x'y3%qPr9   c                      t         j                          t        j                          t        j                          t        j                          y)zClear all LRU caches.N)r  cache_clearr\  rX  r[  r8   r9   r:   r  r  L  s4     &&( r9   c                      t         j                         t        j                         t        j                         t        j                         dS )zReport cache statistics.)r0   r1   r   r2   )r\  
cache_infor  rX  r[  r8   r9   r:   r  r  U  s>     $..0#..0,779'224	 r9   idna_encode_sizeidna_decode_sizeip_address_sizehost_validate_sizer  r  r  r  c                      t        |       t        j                        a t        |      t        j                        a t        |      t        j                        a t        |      t
        j                        ay)zConfigure LRU cache sizes.N)r   r\  __wrapped__r  rX  r[  r  s       r:   cache_configurer  `  si     /9-.|/G/GHL.9-.|/G/GHL7Y7** 3Y12>3M3MNNr9   r  )Or  resysr   collections.abcr   r   
contextlibr   	functoolsr   r   	ipaddressr   typingr	   r
   r   r   r   r   r   r   r   r   r   r   urllib.parser   r   r   r   r   r   r   r  	multidictr   r   r   _helpersr    _quotingr!   r"   r   	frozensetr  r  r   r   sentinelcompileVERBOSEr  rB   rf   r  SimpleQueryr  r  r*   version_infor-   r/   r<   rE   rk   ry   r]   r  	_MAXCACHEr  r\  rX  r[  r  r  r  r8   r9   r:   <module>r      s    	 
  -  +         5 5 % (cCK;'-( !!FG 8
 

 JJ CeO$k#::;#,.SS	 T]wD	 y "	 "J r 
 49 0 o o od+BE#t)$ Bc BeCI6F B 	 92c 2c 2 2 93s 3s 3 3 9%3 %5c? % % 9   " ! ! I    *3)2(1+4OCI&O CI&O 39%	O
 c4i(O 
O Or9   