a !fA @sdZddlZddlZddlZddlZddlmZdZdZdZ e dZ e d j d d d d ddZ e dj ddddZe d e d e d e d e de de de ddZe dZe dZGdddejZd5eejeedddZeedddZejejeefeejed d!d"Zeeedd#d$d%Zeed&d'd(Zeed)d*d+Zd6eeed-d.d/Zd7eeed-d0d1Z ej!ej"eefed2d3d4Z#dS)8a 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. N) InvalidURLizBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~z !$&'()*+,;=z%[A-Fa-f0-9]{2}z(?:(?P{scheme}):)?(?://(?P{authority}))?(?P{path})(?:\?(?P{query}))?(?:#(?P{fragment}))?z([a-zA-Z][a-zA-Z0-9+.-]*)?z[^/?#]*z[^?#]*z[^#]*z.*scheme authoritypathqueryfragmentzA(?:(?P{userinfo})@)?(?P{host}):?(?P{port})?z[^@]*z(\[.*\]|[^:]*))userinfohostport)rrrrr r r r z ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$z^\[.*\]$c@seZdZUeed<eed<eed<ejeed<eed<ejeed<ejeed<eedd d Z eedd d Z ejedd ddZ edddZ dS) ParseResultrr r r rrr )returncCsRd|jr|jdndd|jvr0d|jdn|j|jdurJd|jndgS)N@:[])joinr r r selfrP/var/www/html/python-backend/venv/lib/python3.9/site-packages/httpx/_urlparse.pyrgs zParseResult.authoritycCs>dd|jvrd|jdn|j|jdur6d|jndgS)Nrrrr)rr r rrrrnetlocqs zParseResult.netloc)kwargsrcKs:|s|S|j|j|j|j|jd}||tdi|S)Nrr)r)rrrrr updateurlparse)rrdefaultsrrr copy_withzs zParseResult.copy_withcCsh|j}d|jr|jdnd|r,d|nd|j|jdurHd|jnd|jdur`d|jndgS)Nrr//?#)rrrrrr )rrrrr__str__szParseResult.__str__N) __name__ __module__ __qualname__str__annotations__typingOptionalintpropertyrrrr"rrrrr ^s  r r)urlrrcKst|tkrtdtdd|Dr.tdd|vrX|d}t|trPt|n||d<d|vr|dpld}|d\|d <}|d<d |vsd |vrt |d dpd}t |d dpd}|r|d|n||d <d |vr|d pd}|d\|d<}|d<|sd|d<d |vrb| d p.d} d| vrb| drR| dsbd| d|d <| D]v\} } | durjt| tkrtd| dtdd| Drtd| dt| | sjtd| dqjt|} | dusJ| } | d| dpd}| d| dp,d}| d| dpBd}| d| d}| d| d}t|}|dus|J|}| d |d pd}| d |d pd} | d|d}|}t |tdd}t| }t||}|dk}|dkp |dkp |du}t|||d|r*t|}t |tdd}|durHdnt |tdd}|durfdnt |td d}t|||||||S)!Nz URL too longcss |]}|o| VqdSNisascii isprintable.0charrrr zurlparse..z,Invalid non-printable ASCII character in URLr rrrr usernamepasswordr raw_pathr rrrrzURL component 'z ' too longcss |]}|o| VqdSr-r.r1rrrr4r5z8Invalid non-printable ASCII character in URL component ''zInvalid URL component 'rrr safe) has_scheme has_authorityz:/[]@z:?[]@z:/?#[]@)lenMAX_URL_LENGTHrany isinstancer*r&pop partitionquoteget startswithendswithitemsCOMPONENT_REGEX fullmatch URL_REGEXmatch groupdictAUTHORITY_REGEXlower SUB_DELIMS encode_hostnormalize_port validate_pathnormalize_pathr )r,rr r_r6r7r8Z seperatorr keyvalueZ url_matchZurl_dictrrrrr Zauthority_matchZauthority_dictr Z parsed_schemeZparsed_userinfoZ parsed_hostZ parsed_portr<r=Z parsed_pathZ parsed_queryZparsed_fragmentrrrrs   "     r)r rcCs|sdSt|rHzt|Wn"tjyBtd|Yn0|St|rzt|ddWn"tjytd|Yn0|ddS|rt | t dSzt | dWSt jytd|Yn0dS) NrzInvalid IPv4 address: rzInvalid IPv6 address: r:asciizInvalid IDNA hostname: )IPv4_STYLE_HOSTNAMErL ipaddress IPv4AddressAddressValueErrorrIPv6_STYLE_HOSTNAME IPv6Addressr/rDrOrPidnaencodedecode IDNAError)r rrrrQs(   rQ)r rrcCsh|dus|dkrdSz t|}Wn ty@td|Yn0dddddd|}||krddS|S)NrzInvalid port: Pi)ftphttphttpswswss)r* ValueErrorrrE)r rZ port_as_int default_portrrrrRLs   rR)rr<r=rcCsH|r|rD|dsDtdn(|dr.td|drD|sDtddS)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 '/'rzFURLs with no authority component cannot have a path starting with '//'rzBURLs with no scheme component cannot have a path starting with ':'N)rFr)rr<r=rrrrSis  rS)rrcCsV|d}g}|D]8}|dkr q|dkr@|rJ|dgkrJ|q||qd|S)z Drop "." and ".." segments from a URL path. For example: normalize_path("/path/./to/somewhere/..") == "/path/to" rm.z..r)splitrBappendr)r componentsoutput componentrrrrTs   rT)r3rcCsddd|dDS)a  Replace a single character with the percent-encoded representation. Characters outside the ASCII range are represented with their a percent-encoded representation of their UTF-8 byte sequence. For example: percent_encode(" ") == "%20" rcSsg|]}d|dqS)%02xr)r2byterrr r5z"percent_encode..zutf-8)rraupper)r3rrrpercent_encodes ryrm)stringr;rcCs<t|d}|D]}||vrdSq|dtt|kS)z< Determine if a given string is already quote-safe. rtF)UNRESERVED_CHARACTERScountr>PERCENT_ENCODED_REGEXfindall)rzr;NON_ESCAPED_CHARSr3rrris_safes  rcs0t||dr|St|dfdd|DS)z= Use percent-encoding to quote a string if required. r:rcs g|]}|vr|nt|qSr)ryr1rrrrwr5zquote..)rr{r)rzr;rrrrDs  rD)rHrcCsddd|DS)N&cSs,g|]$\}}t|dddt|ddqS)rr:=)rD)r2kvrrrrwr5zurlencode..)r)rHrrr urlencodes r)r)rm)rm)$__doc__r[rer(r` _exceptionsrr?r{rPcompiler}formatrKrNrIrZr^ NamedTupler r&r)rrQUnionr*rRboolrSrTryrrDListTuplerrrrrsh    7 /