jE SrSSKJr SSKrSSKrSSKrSSKrSSKJr Sr Sr Sr \R"S 5r \R"S RS S S SSS95r\R"SRSSSS95r\R"S 5\R"S 5\R"S 5\R"S5\R"S5\R"S5\R"S5\R"S5S.r\R"S5r\R"S5r"SS\R(5rS$S%SjjrS&SjrS'SjrS(SjrS)SjrS*S jrS+S,S!jjrS+S,S"jjrS-S#jrg).a 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) 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(\[.*\]|[^:@]*))userinfohostportz[^@]*z(\[.*\]|[^:]*))rrr r r r r rz ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$z^\[.*\]$c\rSrSr%S\S'S\S'S\S'S\S'S\S'S \S 'S \S '\SS j5r\SS j5rSSjrSSjr Sr g) ParseResultastrrr r int | Nonerr str | Noner r cSRUR(aURS3OSSUR;aSURS3O URURbSUR3/5$S/5$)N@:[])joinr r rselfs Y/home/ubuntu/second-brain/public-api/venv/lib/python3.13/site-packages/httpx/_urlparse.pyrParseResult.authorityjszww'+}}4==/#"$'499$4!DII;a $))#'99#8!DII;   ?A   cSRSUR;aSURS3O URURbSUR3/5$S/5$)Nrrrr)rr rrs rnetlocParseResult.netloctsdww$'499$4!DII;a $))#'99#8!DII;   ?A   r c U(dU$URURURURURS.nUR U5 [ S0UD6$)Nrr)rrr r r updateurlparse)rkwargsdefaultss r copy_withParseResult.copy_with}sRKkkIIZZ   'h''r c,URnSRUR(aURS3OSU(aSU3OSURURbSUR3OSUR bSUR 3/5$S/5$)Nrr//?#)rrrr r r )rrs r__str__ParseResult.__str__sNN ww%)[[4;;-q!b$-"YK 2 $(JJ$:!DJJ< '+}}'@!DMM?#    GI    r N)returnr)r(rr3r) __name__ __module__ __qualname____firstlineno____annotations__propertyrr"r*r0__static_attributes__r2r rrrasX KM I  I       (  r rc : [U5[:a [S5e[SU55(a8[ SU55nUR U5nSU<SUS3n[U5eSU;a*USn[ U[5(a [U5OUUS'SU;a4URS5=(d S nURS 5uUS 'oqS'S U;dS U;a[[URS S 5=(d S 5n[URS S 5=(d S 5n U (aUS U 3OUUS'SU;a@URS5=(d S n U RS5uUS'oS'U (dSUS'S U;aUURS 5=(d S n S U ;a5U RS5(aU RS5(d SU S3US 'UR5HupUcM [U5[:a[SU S35e[SU55(a;[ SU55nUR U5nSU SU<SUS3n[U5e[ U R#U5(aM[SU S35e [$R'U5nUceUR)5nURSUS5=(d S nURSUS5=(d S nURSUS5=(d S nURSUS5nURSUS5n[*R'U5nUceUR)5nURSUS5=(d S nURS US 5=(d S n URSUS5nUR-5n[U[.S -S 9n[1U 5nU5nUS :gnUS :g=(d US :g=(d USLn[5UUUS!9 U(dU(a [7U5nS"n[U[.U-S#-S 9n UcSO[U[.U-S$-S 9n!UcSO[U[.U-S%-S 9n"[9UUUUU U!U"5$)&Nz URL too longc3x# UH0oR5=(a UR5(+v M2 g7fNisascii isprintable.0chars r urlparse..s( E<<> 4$"2"2"44 48:c3# UH4oR5(dMUR5(aM0Uv M6 g7fr=r>rAs rrDrEs%VSTLLND4CSCSCUDDS >> >z.Invalid non-printable ASCII character in URL, z at position .rr"rrr usernamepasswordr raw_pathr.r r rrzURL component 'z ' too longc3x# UH0oR5=(a UR5(+v M2 g7fr=r>rAs rrDrEs(O<<><$*:*:*<&<<rFc3# UH4oR5(dMUR5(aM0Uv M6 g7fr=r>rAs rrDrEs(%*TllnDTEUEUEWDDUrHz-Invalid non-printable ASCII character in URL z component, zInvalid URL component ''rrr safe) has_scheme has_authorityz`{}%|^\"z:/[]@z:/?[]@z:/?#[]@)lenMAX_URL_LENGTHranynextfind isinstanceintrpop partitionquoteget startswithendswithitemsCOMPONENT_REGEX fullmatch URL_REGEXmatch groupdictAUTHORITY_REGEXlower SUB_DELIMS encode_hostnormalize_port validate_pathnormalize_pathr)#urlr(rCidxerrorrr"_rJrKrL seperatorr keyvalue url_matchurl_dictrrr r r authority_matchauthority_dictr parsed_schemeparsed_userinfo parsed_host parsed_portrRrS WHATWG_SAFE parsed_path parsed_queryparsed_fragments# rr'r's  3x. (( E EEEVSVVhhtnVzV3J39r:J39r:9Az8*5xzV::j)/R5=5G5G5L2v '?"F7Ozz&!'R $; 4 4s9K9K a[F6N lln   5zN* ?3%z!BCCOOOO%*jj&CC5 hmC53!''#3'11%88 #:3%q!ABB)%.$I   ""$HZZ(8"4 5 ;F ;(=>D"I ::fhv. / 52D JJw 1 2Ezz*hz&:;H&++I6O  && &$..0Nzz*nZ&@AGRH ::fnV4 5 ;D ::fnV4 5D  M  S0@AO"4(K,T6:K"$J2M!2Mk6M$:]K]d# KT [(@7(JKK = 5zK7(B C   8*{":Y"F G  r cU(dg[RU5(a[R"U5 U$[ RU5(a[R"USS5 USS$UR5(a!Sn[UR5[U-S9$[R"UR55RS5$![Ra [ SU<35ef=f![Ra [ SU<35ef=f![Ra [ S U<35ef=f) NrzInvalid IPv4 address: rzInvalid IPv6 address: z"`{}%|\rPasciizInvalid IDNA hostname: )IPv4_STYLE_HOSTNAMEre ipaddress IPv4AddressAddressValueErrorrIPv6_STYLE_HOSTNAME IPv6Addressr?r]rhriidnaencodedecode IDNAError)r r}s rrjrj/s:   " "4 ( (  @  ! !$ '  " "4 ( ( @  ! !$q* -Abz  ! TZZ\ [(@AA={{4::<(//88=** @5dX>? ? @** @5dX>? ? @ >>=24(;<<=s#CD,2D-$D$D*-$EcUbUS:Xag[U5nSSSSSS.RU5nX#:XagU$![a [SU<35ef=f)NrzInvalid port: Pi)ftphttphttpswswss)rZ ValueErrorrr^)rr port_as_int default_ports rrkrk^st |trz4$i rCr#NRRL"  4>$2334s 6AcU(a(U(a!URS5(d [S5eU(dKU(dCURS5(a [S5eURS5(a [S5eggg)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 '//'rz2Relative URLs cannot have a path starting with ':'N)r_r)r rRrSs rrlrlysq ,,VW W m ??4 RS S ??3  QR R ,:r cSU;aU$URS5nSU;aSU;aU$/nUHFnUS:XaM US:Xa$U(aUS/:waUR5 M1M3M5URU5 MH SRU5$)zx Drop "." and ".." segments from a URL path. For example: normalize_path("/path/./to/somewhere/..") == "/path/to" rIrz..r)splitr[appendr)r componentsoutput components rrmrms $ CJ *Z!7 F    $ &RD. )v MM) $  88F r cvSRURS5Vs/sH nSUS3PM sn5$s snf)Nrzutf-8%02X)rr)stringbytes rPERCENTrs6 77v}}W/EF/EtaSzN/EF GGFs6c[U-nURU5(dU$SRUVs/sHo3U;aUO [U5PM sn5$s snf)z) Use percent-encoding to quote a string. r)UNRESERVED_CHARACTERSrstriprr)rrQNON_ESCAPED_CHARSrCs rpercent_encodedrs[.4 ==* + + 77JPQ&$** =&Q QsAc/nSn[R"[U5HgnUR5UR 5peUR S5nXS:waXUnUR [XS95 UR U5 UnMi U[U5:waXSn UR [XS95 SRU5$)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 rrPNr) refinditerPERCENT_ENCODED_REGEXstartendgrouprrrTr) rrQpartscurrent_positionrestart_position end_position matched_text leading_text trailing_texts rr]r]s E2F;',{{}eiik {{1~  -!>BL LLA B  \"'<3v;&01  _]>? 775>r c SRUVVs/sHup[USS9S-[USS9-PM snn5$s snnf)aE We can use a much simpler version of the stdlib urlencode here because we don't need to handle a bunch of different typing cases, such as bytes vs str. https://github.com/python/cpython/blob/b2f7b2ef0b5421e01efb8c7bee2ef95d3bab77eb/Lib/urllib/parse.py#L926 Note that we use '%20' encoding for spaces. and '%2F for '/'. This is slightly different than `requests`, but is the behaviour that browsers use. See - https://github.com/encode/httpx/issues/2536 - https://github.com/encode/httpx/issues/2721 - https://docs.python.org/3/library/urllib.parse.html#urllib.parse.urlencode &rrP=)rr)rakvs r urlencodersQ 88  AB '# -0K K   s$= r%)rnrr(rr3r)r rr3r)rzstr | int | Nonerrr3r)r rrRboolrSrr3None)r rr3r)rrr3r)r)rrrQrr3r)razlist[tuple[str, str]]r3r)__doc__ __future__rrrtypingr _exceptionsrrUrricompilerformatrdrgrbrr NamedTuplerr'rjrkrlrmrrr]rr2r rrsw$# #I  #45 JJ *  f+     &**T f     jj56I& JJx ZZ  4  7# JJ) * JJt  jj!DEjj-4 &##4 nTn,=^6S2>H Br