a
    ”˜ëjrH  ã                
   @  s  d Z ddlmZ ddlZddlZddlZddlZddlmZ dZ	dZ
dZe d	¡Zd
 dd„ eddƒD ƒ¡Zd
 dd„ eddƒD ƒ¡Zd
 dd„ eddƒD ƒ¡Zd
 dd„ eddƒD ƒ¡Zd
 dd„ eddƒD ƒ¡Zd
 dd„ eddƒD ƒ¡Ze djdddddd�¡Ze djdddd�¡Ze d¡e d¡e d¡e d¡e d¡e d¡e d¡e d¡d œZe d!¡Ze d"¡ZG d#d$„ d$ejƒZdBd%d&d$d'œd(d)„Zd%d%d*œd+d,„Zd-d%d.d/œd0d1„Z d%d2d2d3d4œd5d6„Z!d%d%d7œd8d9„Z"d%d%d:œd;d<„Z#d%d%d%d=œd>d?„Z$d%d%d%d=œd@dA„Z%dS )Caï  
An implementation of `urlparse` that provides URL validation and normalization
as described by RFC3986.

We rely on this implementation rather than the one in Python's stdlib, because:

* It provides more complete URL validation.
* It properly differentiates between an empty querystring and an absent querystring,
  to distinguish URLs with a trailing '?'.
* It handles scheme, hostname, port, and path normalization.
* It supports IDNA hostnames, normalizing them to their encoded form.
* The API supports passing individual components, as well as the complete URL string.

Previously we relied on the excellent `rfc3986` package to handle URL parsing and
validation, but this module provides a simpler alternative, with less indirection
required.
é    )ÚannotationsNé   )Ú
InvalidURLi   zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~z!$&'()*+,;=z%[A-Fa-f0-9]{2}Ú c                 C  s   g | ]}|d vrt |ƒ‘qS ))é    é"   é<   é>   é`   ©Úchr©Ú.0Úi© r   úN/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/httpx/_urlparse.pyÚ
<listcomp>,   ó    r   r   é   c                 C  s   g | ]}|d vrt |ƒ‘qS ))r   r   é#   r   r	   r   r   r   r   r   r   2   r   c                 C  s   g | ]}|d vrt |ƒ‘qS ))	r   r   r   r   r	   é?   r
   é{   é}   r   r   r   r   r   r   8   s   þc                 C  s   g | ]}|d vrt |ƒ‘qS ©)r   r   r   r   r	   r   r
   r   r   é/   é:   é;   é=   é@   é[   é\   é]   é^   é|   r   r   r   r   r   r   C   s
   ÿþc                 C  s   g | ]}|d vrt |ƒ‘qS r   r   r   r   r   r   r   M   s
   ÿþc                 C  s   g | ]}|d vrt |ƒ‘qS ))r   r   r   r   r	   r   r
   r   r   r   r   r   r   r   r    r!   r"   r#   r   r   r   r   r   r   Z   s
   ÿþz‚(?:(?P<scheme>{scheme}):)?(?://(?P<authority>{authority}))?(?P<path>{path})(?:\?(?P<query>{query}))?(?:#(?P<fragment>{fragment}))?z([a-zA-Z][a-zA-Z0-9+.-]*)?z[^/?#]*z[^?#]*z[^#]*z.*©ÚschemeÚ	authorityÚpathÚqueryÚfragmentzA(?:(?P<userinfo>{userinfo})@)?(?P<host>{host}):?(?P<port>{port})?z(\[.*\]|[^:@]*))ÚuserinfoÚhostÚportz[^@]*z(\[.*\]|[^:]*))r%   r&   r'   r(   r)   r*   r+   r,   z ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$z^\[.*\]$c                   @  sˆ   e Zd ZU ded< ded< ded< ded< ded< ded	< ded
< eddœdd„ƒZeddœdd„ƒZdd dœdd„Zddœdd„ZdS )ÚParseResultÚstrr%   r*   r+   ú
int | Noner,   r'   ú
str | Noner(   r)   )Úreturnc                 C  sR   d  | jr| j› d�ndd| jv r0d| j› d�n| j| jd urJd| j› �ndg¡S )Nr   ú@ú:ú[ú])Újoinr*   r+   r,   ©Úselfr   r   r   r&   §   s    ýÿzParseResult.authorityc                 C  s>   d  d| jv rd| j› d�n| j| jd ur6d| j› �ndg¡S )Nr   r3   r4   r5   )r6   r+   r,   r7   r   r   r   Únetloc±   s
    þÿzParseResult.netloc)Úkwargsr1   c                 K  s:   |s| S | j | j| j| j| jdœ}| |¡ tdi |¤ŽS )Nr$   r   )r   )r%   r&   r'   r(   r)   ÚupdateÚurlparse)r8   r:   Údefaultsr   r   r   Ú	copy_withº   s    û
zParseResult.copy_withc                 C  sh   | j }d | jr| j› d�nd|r,d|› �nd| j| jd urHd| j› �nd| jd ur`d| j› �ndg¡S )Nr   r3   ú//ú?ú#)r&   r6   r%   r'   r(   r)   )r8   r&   r   r   r   Ú__str__È   s    ûÿzParseResult.__str__N)	Ú__name__Ú
__module__Ú__qualname__Ú__annotations__Úpropertyr&   r9   r>   rB   r   r   r   r   r-   ž   s   
	r-   r.   r0   )Úurlr:   r1   c           "      K  sè  t | ƒtkrtdƒ‚tdd„ | D ƒƒr\tdd„ | D ƒƒ}|  |¡}d|›d|› d�}t|ƒ‚d|v r†|d }t|tƒr~t|ƒn||d< d	|v r´| 	d	¡pšd
}| 
d¡\|d< }|d< d|v sÆd|v �rt| 	dd
¡pÖd
td�}t| 	dd
¡pîd
td�}	|	�r
|› d|	› �n||d< d|v �rR| 	d¡�p*d
}
|
 
d¡\|d< }|d< |�sRd |d< d|v �rž| d¡�pjd
}d|v �rž| d¡�rŽ| d¡�sžd|› d�|d< | ¡ D ]¢\}}|d u�r¦t |ƒtk�rÖtd|› d�ƒ‚tdd„ |D ƒƒ�r&tdd„ |D ƒƒ}| |¡}d|› d|›d|› d�}t|ƒ‚t|  |¡�s¦td|› d�ƒ‚�q¦t | ¡}|d u�sbJ ‚| ¡ }| d|d ¡�p~d
}| d |d  ¡�p”d
}| d|d ¡�pªd
}| d|d ¡}| d!|d! ¡}t |¡}|d u�säJ ‚| ¡ }| d|d ¡�p d
}| d|d ¡�pd
}| d|d ¡}| ¡ }t|td�}t|ƒ}t||ƒ}|d
k}|d
k�pp|d
k�pp|d u}t|||d"� |�sŒ|�r”t|ƒ}t|td�}|d u �r®d n
t|td�} |d u �rÈd n
t|t d�}!t!|||||| |!ƒS )#NzURL too longc                 s  s    | ]}|  ¡ o| ¡  V  qd S ©N©ÚisasciiÚisprintable©r   Úcharr   r   r   Ú	<genexpr>ß   r   zurlparse.<locals>.<genexpr>c                 s  s"   | ]}|  ¡ r| ¡ s|V  qd S rI   rJ   rM   r   r   r   rO   à   r   z.Invalid non-printable ASCII character in URL, z at position Ú.r,   r9   r   r3   r+   ÚusernameÚpassword©Úsafer*   Úraw_pathr@   r'   r(   r4   r5   zURL component 'z
' too longc                 s  s    | ]}|  ¡ o| ¡  V  qd S rI   rJ   rM   r   r   r   rO     r   c                 s  s"   | ]}|  ¡ r| ¡ s|V  qd S rI   rJ   rM   r   r   r   rO     s   z-Invalid non-printable ASCII character in URL z component, zInvalid URL component 'ú'r%   r&   r)   )Ú
has_schemeÚhas_authority)"ÚlenÚMAX_URL_LENGTHr   ÚanyÚnextÚfindÚ
isinstanceÚintr.   ÚpopÚ	partitionÚquoteÚUSERNAME_SAFEÚPASSWORD_SAFEÚgetÚ
startswithÚendswithÚitemsÚCOMPONENT_REGEXÚ	fullmatchÚ	URL_REGEXÚmatchÚ	groupdictÚAUTHORITY_REGEXÚlowerÚUSERINFO_SAFEÚencode_hostÚnormalize_portÚvalidate_pathÚnormalize_pathÚ	PATH_SAFEÚ
QUERY_SAFEÚ	FRAG_SAFEr-   )"rH   r:   rN   ÚidxÚerrorr,   r9   Ú_rQ   rR   rU   Z	seperatorr+   ÚkeyÚvalueZ	url_matchZurl_dictr%   r&   r'   r(   ÚfragZauthority_matchZauthority_dictr*   Zparsed_schemeZparsed_userinfoZparsed_hostZparsed_portrW   rX   Zparsed_pathZparsed_queryZparsed_fragr   r   r   r<   Õ   s¢    
ÿ

"
ÿ
ÿÿÿ


ÿùr<   )r+   r1   c                 C  sö   | sdS t  | ¡rHzt | ¡ W n" tjyB   td| ›�ƒ‚Y n0 | S t | ¡r˜zt | dd… ¡ W n" tjyŠ   td| ›�ƒ‚Y n0 | dd… S |  ¡ r¸d}t	|  
¡ t| d�S zt |  
¡ ¡ d¡W S  tjyð   td	| ›�ƒ‚Y n0 d S )
Nr   zInvalid IPv4 address: r   éÿÿÿÿzInvalid IPv6 address: z"`{}%|\rS   ÚasciizInvalid IDNA hostname: )ÚIPv4_STYLE_HOSTNAMErl   Ú	ipaddressÚIPv4AddressÚAddressValueErrorr   ÚIPv6_STYLE_HOSTNAMEÚIPv6AddressrK   rb   ro   Ú
SUB_DELIMSÚidnaÚencodeÚdecodeÚ	IDNAError)r+   ZWHATWG_SAFEr   r   r   rq   \  s*    

	rq   zstr | int | Noner/   )r,   r%   r1   c                 C  sh   | d u s| dkrd S zt | ƒ}W n  ty@   td| ›�ƒ‚Y n0 ddddddœ |¡}||krdd S |S )Nr   zInvalid port: é   éP   i»  )ÚftpÚhttpÚhttpsÚwsÚwss)r_   Ú
ValueErrorr   re   )r,   r%   Zport_as_intÚdefault_portr   r   r   rr   ‹  s    
ÿrr   ÚboolÚNone)r'   rW   rX   r1   c                 C  sJ   |r| r|   d¡stdƒ‚|sF|sF|   d¡r4tdƒ‚|   d¡rFtdƒ‚dS )z¯
    Path validation rules that depend on if the URL contains
    a scheme or authority component.

    See https://datatracker.ietf.org/doc/html/rfc3986.html#section-3.3
    ú/z7For absolute URLs, path must be empty or begin with '/'r?   z3Relative URLs cannot have a path starting with '//'r3   z2Relative URLs cannot have a path starting with ':'N)rf   r   )r'   rW   rX   r   r   r   rs   ¦  s    

rs   )r'   r1   c                 C  sv   d| vr| S |   d¡}d|vr*d|vr*| S g }|D ]8}|dkr@q2|dkr`|rj|dgkrj| ¡  q2| |¡ q2d |¡S )zˆ
    Drop "." and ".." segments from a URL path.

    For example:

        normalize_path("/path/./to/somewhere/..") == "/path/to"
    rP   r–   z..r   )Úsplitr`   Úappendr6   )r'   Ú
componentsÚoutputÚ	componentr   r   r   rt   ¿  s    	

rt   )Ústringr1   c                 C  s   d  dd„ |  d¡D ƒ¡S )Nr   c                 S  s   g | ]}d |d›�‘qS )ú%Z02Xr   )r   Úbyter   r   r   r   ß  r   zPERCENT.<locals>.<listcomp>zutf-8)r6   rˆ   )rœ   r   r   r   ÚPERCENTÞ  s    rŸ   )rœ   rT   r1   c                   s.   t | ‰ |  ˆ ¡s| S d ‡ fdd„| D ƒ¡S )z1
    Use percent-encoding to quote a string.
    r   c                   s    g | ]}|ˆ v r|nt |ƒ‘qS r   )rŸ   rM   ©ZNON_ESCAPED_CHARSr   r   r   í  r   z#percent_encoded.<locals>.<listcomp>)ÚUNRESERVED_CHARACTERSÚrstripr6   )rœ   rT   r   r    r   Úpercent_encodedâ  s    
ÿr£   c           
      C  sž   g }d}t  t| ¡D ]T}| ¡ | ¡  }}| d¡}||krZ| ||… }| t||d�¡ | |¡ |}q|t| ƒkr”| |d… }	| t|	|d�¡ d 	|¡S )a®  
    Use percent-encoding to quote a string, omitting existing '%xx' escape sequences.

    See: https://www.rfc-editor.org/rfc/rfc3986#section-2.1

    * `string`: The string to be percent-escaped.
    * `safe`: A string containing characters that may be treated as safe, and do not
        need to be escaped. Unreserved characters are always treated as safe.
        See: https://www.rfc-editor.org/rfc/rfc3986#section-2.3
    r   rS   Nr   )
ÚreÚfinditerÚPERCENT_ENCODED_REGEXÚstartÚendÚgroupr˜   r£   rY   r6   )
rœ   rT   ÚpartsÚcurrent_positionrl   Zstart_positionZend_positionZmatched_textZleading_textZtrailing_textr   r   r   rb   ñ  s    

rb   )r   )&Ú__doc__Ú
__future__r   r�   r¤   Útypingr‡   Ú_exceptionsr   rZ   r¡   r†   Úcompiler¦   r6   Úrangerw   rv   ru   rc   rd   rp   Úformatrk   rn   ri   r€   r„   Ú
NamedTupler-   r<   rq   rr   rs   rt   rŸ   r£   rb   r   r   r   r   Ú<module>   s˜   ÿ
ÿÿþÿþÿ
þÿþÿÿõÿÿúÿø

7 /