IiE SrSSKrSSKrSSKrSSKrSSKJr SrSrSr \R"S5r \R"S RS S S S SS95r \R"SRSSSS95r\R"S 5\R"S 5\R"S 5\R"S 5\R"S5\R"S5\R"S5\R"S5S.r\R"S5r\R"S5r"SS\R$5rS1S\S\R*\S\4SjjrS\S\4SjrS \R*\R0\\4S!\S\R*\4S"jrS#\S$\S%\SS4S&jrS#\S\4S'jrS(\S\4S)jrS2S*\S+\S\4S,jjrS2S*\S+\S\4S-jjr S2S*\S+\S\4S.jjr!S/\RD\RF\\4S\4S0jr$g)3a 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(\[.*\]|[^:@]*))userinfohostportz[^@]*z(\[.*\]|[^:]*))rrrr r r r r z ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$z^\[.*\]$c\rSrSr%\\S'\\S'\\S'\R\\S'\\S'\R\\S'\R\\S'\ S \4S j5r \ S \4S j5r S \R\S S4S jr S \4Sjr Srg) ParseResult^rr r r rr r returncSRUR(aURS3OSSUR;aSURS3O URURbSUR3/5$S/5$)N@:[])joinr r r selfs 5/venv/lib/python3.13/site-packages/httpx/_urlparse.pyrParseResult.authoritygszww'+}}4==/#"$'499$4!DII;a $))#'99#8!DII;   ?A   cSRSUR;aSURS3O URURbSUR3/5$S/5$)Nrrrr)rr r rs rnetlocParseResult.netlocqsdww$'499$4!DII;a $))#'99#8!DII;   ?A   rkwargsc U(dU$URURURURURS.nUR U5 [ S0UD6$)Nrr)rrrr r updateurlparse)rr!defaultss r copy_withParseResult.copy_withzsRKkkIIZZ   'h''rc,URnSRUR(aURS3OSU(aSU3OSURURbSUR3OSUR bSUR 3/5$S/5$)Nrr//?#)rrrrr r )rrs r__str__ParseResult.__str__sNN ww%)[[4;;-q!b$-"YK 2 $(JJ$:!DJJ< '+}}'@!DMM?#    GI    rN)__name__ __module__ __qualname____firstlineno__str__annotations__typingOptionalintpropertyrrr'r-__static_attributes__r/rrrr^s KM I //#  I ??3 ooc""  3      (&//#"6 (= (    rrurlr!rc b[U5[:a [S5e[SU55(a [S5eSU;a*USn[ U[ 5(a [ U5OUUS'SU;a4URS5=(d SnURS5uUS'oAS'S U;dS U;a[[URS S5=(d S5n[URS S5=(d S5nU(aUSU3OUUS 'S U;a@URS 5=(d SnURS 5uUS'oS'U(dSUS'SU;aUURS5=(d Sn SU ;a5U RS5(aU RS5(d SU S3US'UR5H~upU cM [U 5[:a[SU S35e[SU 55(a[SU S35e[U RU 5(aMq[SU S35e [ R#U5n U ceU R%5n URSU S5=(d SnURSU S5=(d SnURSU S5=(d SnURSU S5nURSU S5n[&R#U5nUceUR%5nURS US 5=(d SnURSUS5=(d Sn URSUS5nUR)5n[U[*S-S9n[-U 5n[/X.5nUS:gnUS:g=(d US:g=(d USLnUUS9 U(a [3U5n[U[*S-S9nUcSO[U[*S-S9nUcSO[U[*S-S9n[5UUUUUUU5$) Nz URL too longc3x# UH0oR5=(a UR5(+v M2 g7fNisascii isprintable.0chars r urlparse..s( E<<> 4$"2"2"44 48:z,Invalid non-printable ASCII character in URLr rrrr usernamepasswordr raw_pathr+rr rrzURL component 'z ' too longc3x# UH0oR5=(a UR5(+v M2 g7fr>r?rBs rrErFs(O<<><$*:*:*<&<<rGz8Invalid non-printable ASCII character in URL component ''zInvalid URL component 'rrr safe) has_scheme has_authorityz:/[]@z:/?[]@z:/?#[]@)lenMAX_URL_LENGTHrany isinstancer8r4pop partitionquoteget startswithendswithitemsCOMPONENT_REGEX fullmatch URL_REGEXmatch groupdictAUTHORITY_REGEXlower SUB_DELIMS encode_hostnormalize_port validate_pathnormalize_pathr)r;r!r r_rHrIrJ seperatorr keyvalue url_matchurl_dictrrrr r authority_matchauthority_dictr parsed_schemeparsed_userinfo parsed_host parsed_portrOrP parsed_path parsed_queryparsed_fragments rr%r%s.  3x. (( E EEEGHH f~&0s&;&;Tv6H%+,2,<,VzV3J39r:J39r:9Az8*5xzV::j)/R5=5G5G5L2v '?"F7Ozz&!'R $; 4 4s9K9K a[F6N lln   5zN* ?3%z!BCCOOOO NseSTU #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(6t(DK"$J2M!2Mk6M$:]Kd#T W(<=K 5Z(5J#K  eH: ;Q&R  rr cU(dg[RU5(a[R"U5 U$[ RU5(a[R"USS5 USS$UR5(a[UR5[S9$[R"UR55RS5$![Ra [ SU<35ef=f![Ra [ SU<35ef=f![Ra [ SU<35ef=f) NrzInvalid IPv4 address: rzInvalid IPv6 address: rMasciizInvalid IDNA hostname: )IPv4_STYLE_HOSTNAMEr_ ipaddress IPv4AddressAddressValueErrorrIPv6_STYLE_HOSTNAME IPv6Addressr@rWrbrcidnaencodedecode IDNAError)r s rrdrds0   " "4 ( (  @  ! !$ '  " "4 ( ( @  ! !$q* -Abz  TZZ\ 33={{4::<(//88;** @5dX>? ? @** @5dX>? ? @ >>=24(;<<=s#CD'2D($C>$D%($E r rcUbUS:Xag[U5nSSSSSS.RU5nX#:XagU$![a [SU<35ef=f)NrzInvalid port: Pi)ftphttphttpswswss)r8 ValueErrorrrX)r r port_as_int default_ports rrereJst |trz4$i rCr#NRRL"  4>$2334s 6ArrOrPcU(a*U(a"URS5(d [S5eggURS5(a [S5eURS5(aU(d [S5egg)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*zFURLs with no authority component cannot have a path starting with '//'rzBURLs with no scheme component cannot have a path starting with ':'N)rYr)rrOrPs rrfrfgsy ,,VW W-4 ??4 X  ??3   T )3 rcURS5n/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" r.z..r)splitrUappendr)r componentsoutput components rrgrgsmCJ!F    $ &RD. )v MM) $  88F rrDcSRURS5Vs/sH nSUS3PM sn5R5$s snf)z 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" rzutf-8%02x)rrupper)rDbytes rpercent_encodersA 77t{{7/CD/CtaSzN/CD E K K MMDsAstringrNc<[U-S-nUH nX2;dM g g)z4 Determine if a given string is already quote-safe. rFT)UNRESERVED_CHARACTERSrrNNON_ESCAPED_CHARSrDs ris_safers..4s:  ( rc[XS9(aU$[U-nSRUVs/sHo3U;aUO [U5PM sn5$s snf)z) Use percent-encoding to quote a string. rMr)rrrrrs rpercent_encodedrsTv! -4 77QWXQW**t0D DQWX XsA c/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 rrMNr) refinditerPERCENT_ENCODED_REGEXstartendgrouprrrQr) rrNpartscurrent_positionr_start_position end_position matched_text leading_text trailing_texts rrWrWs E2F;',{{}eiik {{1~  -!>BL LLA B  \"'<3v;&01  _]>? 775>rr[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 &rrM=)rr)r[kvs r urlencodersQ 88  AB '# -0K K   s$= r#)r)%__doc__r{rr6r _exceptionsrrRrrccompilerformatr^rar\rzr~ NamedTuplerr4r7r%rdUnionr8reboolrfrgrrrrWListTuplerr/rrrs{" #I  #45 JJ *  f+     &**T f     jj56I& JJx ZZ  4  7# JJ) * JJt  jj!DEjj-4 &##4 nD#Dfooc&:D{DN+=c+=c+=\ //&,,sCx0 1;> __S:dt6, N N N C s T  C s S #S3BV[[c3h!78Sr