+hs UdZddlmZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl m Z ddl mZd d lmZd d lmZd d lmZd d lmZd dlmZej,rd dlmZej2dZdZeej;dZdZeDcic]*}eD]#}||j;de ||d%,c}}Z!e"dDcgc]}d|dj;dc}Z#GddejHZ%Gdde%Z&Gdde&Z'Gdde&Z(ee!iZ)d e*d!<dHdId"Z+ dJd#Z,dHdKd$Z- dL dMd%Z. dN dOd&Z/e/Z0e/d'd()Z1dPd*Z2 dN dQd+Z3 dR dSd,Z4dTd-Z5 dU dVd.Z6 dW dXd/Z7dYdZd0Z8d[d1Z9ejtd2e9d\d3Z;ee;d7e>Z?e;d8e>d9zZ@e;d:e>d;zZAe;dd=zZB d] d^d>ZC d_ d`d?ZDdad@ZE db dcdAZF dd dedBZG dfdCZH dg dhdDZI di djdEZJ dk dldFZK dY dmdGZLycc}}wcc}w)nzFunctions for working with URLs. Contains implementations of functions from :mod:`urllib.parse` that handle bytes and strings. ) annotationsN)quote)unquote) urlencode)urlsplit) urlunsplit)_check_str_tuple) _decode_idna)_make_encode_wrapper)_to_striter_multi_items)datastructuresz^[a-zA-Z0-9+-.]+$zKabcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~$!'()*+,;ascii0123456789ABCDEFabcdef%02Xc@eZdZUded<ded<ded<ded<ded<y) _URLTuplestrschemenetlocpathqueryfragmentN)__name__ __module__ __qualname____annotations__@/var/www/html/venv/lib/python3.12/site-packages/werkzeug/urls.pyrr2s K K I JMr$rcTeZdZUdZdZded<ded<ded<ded<dfd Zdd Zd d Ze d!d Z e d!d Z e d"d Z e d!dZ e d!dZe d!dZe d!dZe d!dZd#dZddZddZddZddZd$dZd$dZ d% d&dZd'dZd(dZd(dZxZS))BaseURLzSuperclass of :py:class:`URL` and :py:class:`BytesURL`. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use the ``urllib.parse`` library instead. r#r_at_colon _lbracket _rbracketc~tjd|jdtdt ||g|i|S)Nz'werkzeug.urls.z\' is deprecated and will be removed in Werkzeug 3.0. Use the 'urllib.parse' library instead. stacklevel)warningswarnrDeprecationWarningsuper__new__)clsargskwargs __class__s r%r4zBaseURL.__new__GsG cll^,E E   ws4T4V44r$c"|jSN)to_urlselfs r%__str__zBaseURL.__str__Ps{{}r$c &|jdi|S)zReturn an URL with the same values, except for those parameters given new values by whichever keyword arguments are specified.r#)_replace)r=r7s r%replacezBaseURL.replaceSst}}&v&&r$c(|jdS)zThe host part of the URL if available, otherwise `None`. The host is either the hostname or the IP address mentioned in the URL. It will not contain the port. r) _split_hostr<s r%hostz BaseURL.hostXs !!$$r$c|j}|3t|tr# |jdj d}|S|S#t $rY|SwxYw)a Works exactly like :attr:`host` but will return a result that is restricted to ASCII. If it finds a netloc that is not ASCII it will attempt to idna decode it. This is useful for socket operations when the URL might include internationalized characters. idnar)rD isinstancerencodedecode UnicodeErrorr=rvs r% ascii_hostzBaseURL.ascii_host`s]YY >jS1 YYv&--g6 r     s A AAc tt|jd}d|cxkrdkr|Sy y#ttf$rYywxYw)z}The port in the URL as an integer if it was present, `None` otherwise. This does not fill in default ports. r riN)intr rC ValueError TypeErrorrKs r%portz BaseURL.portosf  WT--/234BB%    I&   s188A  A c(|jdS)zSThe authentication part in the URL if available, `None` otherwise. r) _split_netlocr<s r%authz BaseURL.auth|s !!#A&&r$cD|jd}| t|Sy)zThe username if it was part of the URL, `None` otherwise. This undergoes URL decoding and will always be a string. rN _split_auth_url_unquote_legacyrKs r%usernamezBaseURL.username*     " >&r* *r$c(|jdS)zThe username if it was part of the URL, `None` otherwise. Unlike :attr:`username` this one is not being decoded. rrXr<s r% raw_usernamezBaseURL.raw_username !!$$r$cD|jd}| t|Sy)zThe password if it was part of the URL, `None` otherwise. This undergoes URL decoding and will always be a string. r NrWrKs r%passwordzBaseURL.passwordr[r$c(|jdS)zThe password if it was part of the URL, `None` otherwise. Unlike :attr:`password` this one is not being decoded. r r]r<s r% raw_passwordzBaseURL.raw_passwordr_r$c4t|jg|i|S)zDecodes the query part of the URL. Ths is a shortcut for calling :func:`url_decode` on the query argument. The arguments and keyword arguments are forwarded to :func:`url_decode` unchanged. ) url_decoderr=r6r7s r% decode_queryzBaseURL.decode_querys $**6t6v66r$c2tt|g|i|S)zJoins this URL with another one. This is just a convenience function for calling into :meth:`url_join` and then parsing the return value again. ) url_parseurl_joinrfs r%joinz BaseURL.joins $88899r$ct|S)zReturns a URL string or bytes depending on the type of the information stored. This is just a convenience function for calling :meth:`url_unparse` for this URL. ) url_unparser<s r%r;zBaseURL.to_urls 4  r$c |jxsd}d|vrd|d}|j}||d|}djtdt |j xsddddt |j xsddddg}|r|d |}|S) z6Encodes the netloc part to an ASCII safe URL as bytes.:[]Nutf-8strictz/:%@)rMrRrkfilter url_quoter^rc)r=rLrRrUs r% encode_netloczBaseURL.encode_netlocs __ " "9RDByy  4qBxx d//52w%Pd//52w%P   62$B r$c f|jxsd}t|tr|j}t |}d|vrd|d}|j }||d|}dj tdt|jxsddt|jxsddg}|r|d|}|S)z&Decodes the netloc part into a string.rorprqrrNz/:%@ru) rDrGbytesrIr rRrkrvrYr^rc)r=rDrLrRrUs r% decode_netloczBaseURL.decode_netlocsyyB dE ";;=D $  "9RDByy  4qBxx '(9(9(?RH'(9(9(?RH   62$B r$c*tt|S)a*Returns a :class:`BytesURL` tuple that holds a URI. This will encode all the information in the URL properly to ASCII using the rules a web browser would follow. It's usually more interesting to directly call :meth:`iri_to_uri` which will return a string. )ri iri_to_urir<s r% to_uri_tuplezBaseURL.to_uri_tuplesD)**r$c*tt|S)aSReturns a :class:`URL` tuple that holds a IRI. This will try to decode as much information as possible in the URL without losing information similar to how a web browser does it for the URL bar. It's usually more interesting to directly call :meth:`uri_to_iri` which will return a string. )ri uri_to_irir<s r% to_iri_tuplezBaseURL.to_iri_tuplesD)**r$c(|jdk7ryt|j}|jxsd}|tj dk(rd}nd}|dk(r|dddk(r'|dd j r|d d d vr |dd d |d d}|dd d v}ddl}|j|}|rh|f|jdjdd}t|d k(r|\}}n1|d}d}n)|dk(rddl }|j|}ntd||dvrd}||fS)a@Returns a tuple with the location of the file in the form ``(server, location)``. If the netloc is empty in the URL or points to localhost, it's represented as ``None``. The `pathformat` by default is autodetection but needs to be set when working with URLs of a specific system. The supported values are ``'windows'`` when working with Windows or DOS paths and ``'posix'`` when working with posix paths. If the URL does not point to a local file, the server and location are both represented as ``None``. :param pathformat: The expected format of the path component. Currently ``'windows'`` and ``'posix'`` are supported. Defaults to ``None`` which is autodetect. fileNNNntwindowsposixr /r-z|:rp)z\\\z///r\rozInvalid path format )z 127.0.0.1z::1 localhost)r url_unquoterrosnameisalphantpathnormpathlstripsplitlen posixpathrQ)r= pathformatrrD windows_sharerpartsrs r%get_file_locationzBaseURL.get_file_locationsG( ;;& 499%{{"d  ww$& $  "BQx34!9#4#4#64!9;Lq)Ad12hZ0 !H(;;M ??4(D  D)//a8u:?!&JD$ 8DD 7 " %%d+D2:.AB B 4 4DTzr$c|j|jvr-|jj|j\}}}||fSd|jfSr:)r(r partition)r=rU_rs r%rTzBaseURL._split_netloc=sI 88t{{ ""kk33DHH=OD!V< T[[  r$c|jd}|sy|j|vr|dfS|j|j\}}}||fS)Nrr)rTr)r)r=rUrZrras r%rXzBaseURL._split_authCsU!!#A& ;;d ":  $t{{ ;!X!!r$c||jd}|sy|j|js5|j|vr#|j |j\}}}||fS|dfS|j |j }|dkr|dfS|d|}||dzd}|j|jr||ddfS|dfS)Nr rr)rT startswithr*r)rfindr+)r=rLrDrrRidxrests r%rCzBaseURL._split_hostMs    !! $}}T^^,{{b " T[[ 9 aTz!t8Oggdnn% 7t8O!Cy#')} ??4;; 'ab> !Tzr$)r6t.Anyr7rreturnr'rr)r7rrr')r str | None)r int | None)r6rr7rrds.MultiDict[str, str])rr'r:)rrrtuple[str | None, str | None])rztuple[str | None, str])rr)rr r!__doc__ __slots__r"r4r>rApropertyrDrMrRrUrZr^rarcrgrkr;rxr{r~rrrTrXrC __classcell__)r8s@r%r'r':s I H KNN5' %%    '' %% %% 7:!*6+ +(,<$< &<|! "r$r'c.eZdZdZdZdZdZdZdZd d dZ y) URLzRepresents a parsed URL. This behaves like a regular tuple but also has some extra attributes that give further insight into the URL. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use the ``urllib.parse`` library instead. r#rurprqrrc  t|jjd|j|jj|||j j|||j j||S)zEncodes the URL to a tuple made out of bytes. The charset is only being used for the path, query and fragment. r)BytesURLrrHrxrrrr=charseterrorss r%rHz URL.encodersk KK  w '    II  Wf - JJ  gv . MM & 1   r$NrsrA)rrrrrr) rr r!rrr(r)r*r+rHr#r$r%rrcs'I C FII  r$rc>eZdZdZdZdZdZdZdZd dZ d dZ d dd Z y )rzRepresents a parsed URL in bytes. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use the ``urllib.parse`` library instead. r#@:[]cB|jjddS)NrsrA)r;rIr<s r%r>zBytesURL.__str__s{{}##GY77r$c|jS)z&Returns the netloc unchanged as bytes.)rr<s r%rxzBytesURL.encode_netlocs {{r$c  t|jjd|j|jj|||j j|||j j||S)zDecodes the URL to a tuple made out of strings. The charset is only being used for the path, query and fragment. r)rrrIr{rrrrs r%rIzBytesURL.decodesk KK  w '    II  Wf - JJ  gv . MM & 1   r$Nr)rrzr)rrrrrr) rr r!rrr(r)r*r+r>rxrIr#r$r%rrs1 I C FII8  r$rz&dict[frozenset[int], dict[bytes, int]] _unquote_mapsct|tr|jd}t|tr|jd}tt |}t |j d}t t|d} t|}|D]V}|dd}||vr)|j|||j|dd5|jd|j|Xt|S#t$r@tjDcic] \}}||vs ||ncc}}wc}}x}t|<YwxYw)Nrs%r$r-%)rGrrH frozenset bytearrayiterrnextrKeyError _hextobyteitemsappendextendrz) stringunsafegroupsresult hex_to_bytehbgroupcodes r%_unquote_to_bytesrs-&#w'&#w' y( )F &,,t$ %F tFC( )F #F+ !Ray ;  MM+d+ , MM%) $ MM"  MM% ! =  '--// Q1F?AqD/ /  mF+ s$ C66 D? D)#D)(D?>D?c#JKddlm}||}|r t||}|D]}\}}| t|tst |j |}n|}t|tst |j |} n|} t|dt| yw)Nr r)key=)rrsortedrGrzrrH_fast_url_quote_plus) objrsortrriterablekey_str value_str key_bytes value_bytess r%_url_encode_implrs 1,zurl_parse.. sB1AlO3Bs///?#rqrrzInvalid IPv6 URL#?)r0r1r2r rGrr _scheme_rematchr anylowerrminrPrrr)urlrallow_fragments is_text_basedrrrirdelimrwdelim result_typers @r%riris$ MM 0  S!AsC(M ~2 !"%F%UX 3A1u!!'#bq')"DE1q57|sBTBBbq'--/4CF 2Aw!D'C5 +AXXa^F{E6* +!ElCK cFf 3v!5 cFf 3v!5/0 01S6S= !C&!, Xv}YYqvq) U&#HK vvsE8 <.quote=s$ww&1Qa1221s $rrzrr)rGrrHrr _always_saferangechr)rrsaferrrrs @r%_make_fast_url_quoter$s ${{7F+&#w/ io & 59VCT9U UD;@: FaqDySV!Ck 1 FE3 L GsB* +)rrc8t|jddS)Nrr)_fast_quote_plusrA)rs r%rrGs F # + +C 55r$cvtjdtdt|tt t fs t |}t|tr|j||}t|tr|j||}t|tr|j||}tt |tztt |z }t }t |D]0}||vr|j||jt|2t |j|S)aURL encode a single string with a given encoding. :param s: the string to quote. :param charset: the charset to be used. :param safe: an optional sequence of safe characters. :param unsafe: an optional sequence of unsafe characters. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use ``urllib.parse.quote`` instead. .. versionadded:: 0.9.2 The `unsafe` parameter was added. zn'werkzeug.urls.url_quote' is deprecated and will be removed in Werkzeug 3.0. Use 'urllib.parse.quote' instead.r-r.)r0r1r2rGrrzrrHrrrr _bytetohexrI)rrrrrrLchars r%rwrwKs( MM -  fsE95 6V&#w/${{7F+&#w/ io & 59VCT9U UD B&!( 4< IIdO IIj& ' ( 9  G $$r$c~tjdtdt||||dzdj ddS)aOURL encode a single string with the given encoding and convert whitespace to "+". :param s: The string to quote. :param charset: The charset to be used. :param safe: An optional sequence of safe characters. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use ``urllib.parse.quote_plus`` instead. zx'werkzeug.urls.url_quote_plus' is deprecated and will be removed in Werkzeug 2.4. Use 'urllib.parse.quote_plus' instead.r-r.rr)r0r1r2rwrA)rrrrs r%url_quote_plusrxsA MM 7  VWfdSj# > F FsC PPr$ctjdtdt||\}}}}}t |}|d}|s|rK|j |dr4|r|dd|dk7r |d|z}|d|xs|dz|z}n|r||z }|r||d z|z}|r||d z|z}|r||d z|z}|S) aiThe reverse operation to :meth:`url_parse`. This accepts arbitrary as well as :class:`URL` tuples and returns a URL as a string. :param components: the parsed URL as tuple which should be converted into a URL string. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use ``urllib.parse.urlunsplit`` instead. zu'werkzeug.urls.url_unparse' is deprecated and will be removed in Werkzeug 3.0. Use 'urllib.parse.urlunsplit' instead.r-r.rorNr rrprr)r0r1r2r r r) componentsrrrrrrrs r%rmrms MM 2  Z ,6)FFD%V$A B%C &T__QsV4 D!H#&S6D=Dg1R5)D0  t  qvo# AcFlU"AcFlX% Jr$c~tjdtdt||}||S|j ||S)aURL decode a single string with a given encoding. If the charset is set to `None` no decoding is performed and raw bytes are returned. :param s: the string to unquote. :param charset: the charset of the query string. If set to `None` no decoding will take place. :param errors: the error handling for the charset decoding. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use ``urllib.parse.unquote`` instead. zr'werkzeug.urls.url_unquote' is deprecated and will be removed in Werkzeug 3.0. Use 'urllib.parse.unquote' instead.r-r.)r0r1r2rrI)rrrrrLs r%rrsD$ MM /  1f %B 99Wf %%r$ctjdtdt|tr|j dd}n|j dd}t |||S)a&URL decode a single string with the given `charset` and decode "+" to whitespace. Per default encoding errors are ignored. If you want a different behavior you can set `errors` to ``'replace'`` or ``'strict'``. :param s: The string to unquote. :param charset: the charset of the query string. If set to `None` no decoding will take place. :param errors: The error handling for the `charset` decoding. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use ``urllib.parse.unquote_plus`` instead. z|'werkzeug.urls.url_unquote_plus' is deprecated and will be removed in Werkzeug 2.4. Use 'urllib.parse.unquote_plus' instead.r-r.rr+ )r0r1r2rGrrAr)rrrs r%url_unquote_plusrsV" MM 9 !S IIc3  IIdD ! q'6 **r$ctjdtdt||dj dd}|j dr"|dd j r|d d d vrd |dd }t|}t|j|d}t|j|d}t|j|d}t|j|j|||fS)aFSometimes you get an URL by a user that just isn't a real URL because it contains unsafe characters like ' ' and so on. This function can fix some of the problems in a similar way browsers handle data entered by the user: >>> url_fix('http://de.wikipedia.org/wiki/Elf (Begriffskl\xe4rung)') 'http://de.wikipedia.org/wiki/Elf%20(Begriffskl%C3%A4rung)' :param s: the string with the URL to fix. :param charset: The target charset for the URL if the url was given as a string. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. zJ'werkzeug.urls.url_fix' is deprecated and will be removed in Werkzeug 3.0.r-r.rArrzfile:// )z:/z|/zfile:///Nz /%+$!*'(),rz :&%=+$!*'(),)r0r1r2r rArrrirwrrrrrmrrx)rrrrqsanchors r%url_fixrs  MMT 7I&..tS9A ||I1Qq6>>#3!B<8Oqug  A,C SXXw\ :D  7 @B CLL' GF  C$5$5$7r6J KKr$czt|j|j|jd}||jfS)zRUsed in :func:`uri_to_iri` after unquoting to re-quote any invalid bytes. ror)robjectstartend)eouts r%_codec_error_url_quoter$s1 155) 3C :r$werkzeug.url_quotecdjdt|D}tjd|dtjdfd }d||_|S)zCreate a function that unquotes all percent encoded characters except those given. This allows working with unquoted characters if possible while not changing the meaning of a given part of a URL. |c36K|]}t|dyw)rN)ord)rrs r%rz%_make_unquote_part..-s>1#a&>sz((?:%(?:z))+)ctj|}g}|D]9}|jt||||jt |d;dj |Sr)rrrrrrk)rencodingrrr#partpatterns r%_unquote_partialz,_make_unquote_part.._unquote_partial0saW]]5)* (D JJwtXv6 7 JJtE2 ' (wws|r$ _unquote_)rrr+rrrrr)rkrrecompileIr)rcharschoicesr.r-s @r%_make_unquote_partr5(sW hh>u >>Gjj8G9D12448G#,D6 2 r$!rrrz&=+#rruserz:@/?#czt|tr'tjdtdt |}t|t r,tjdtd|j}|tjdtdnd}|tjdtdnd}t|}t|j||}t|j||}t|j||}|jrt!|j}nd }d |vrd |d }|j"r|d |j"}|j$rFt'|j$||}|j(r|d t'|j(||}|d |}t |j*||||fS)aConvert a URI to an IRI. All valid UTF-8 characters are unquoted, leaving all reserved and invalid characters quoted. If the URL has a domain, it is decoded from Punycode. >>> uri_to_iri("http://xn--n3h.net/p%C3%A5th?q=%C3%A8ry%DF") 'http://\u2603.net/p\xe5th?q=\xe8ry%DF' :param uri: The URI to convert. :param charset: The encoding to encode unquoted bytes with. :param errors: Error handler to use during ``bytes.encode``. By default, invalid bytes are left quoted. .. versionchanged:: 2.3 Passing a tuple or bytes, and the ``charset`` and ``errors`` parameters, are deprecated and will be removed in Werkzeug 3.0. .. versionchanged:: 2.3 Which characters remain quoted is specific to each part of the URL. .. versionchanged:: 0.15 All reserved and invalid characters remain quoted. Previously, only some reserved characters were preserved, and invalid bytes were replaced instead of left quoted. .. versionadded:: 0.6 HPassing a tuple is deprecated and will not be supported in Werkzeug 3.0.r-r.FPassing bytes is deprecated and will not be supported in Werkzeug 3.0.JThe 'charset' parameter is deprecated and will be removed in Werkzeug 3.0.rsIThe 'errors' parameter is deprecated and will be removed in Werkzeug 3.0.r%rorprqrrru)rGtupler0r1r2rrzrIr _unquote_pathr_unquote_queryr_unquote_fragmentrhostnamer rRrZ _unquote_userrar) urirrrrrrrrUs r%rrHs>#u V  o#u T  jjl      W  & SME Wf 5D 5;; 8E &AH ~~enn- f}VHA zz81UZZL) ~~U^^Wf= >>V1]5>>7FKLMD66(# u||VT5(C DDr$cx|tjdtdnd}t|tr'tjdtdt |}t|t r-tjdtd|j|}|tjdtdnd}|tjd td|r1 |jd }t|jd k(r|S t|}t|jd || }t|jd|| }t|j d|| }|j"r+|j"jdjd } nd} d| vrd| d} |j$r| d|j$} |j&rHt|j&d} |j(rt|j(d} | d| } | d| } t |j*| |||fS#t$rY0wxYw)a Convert an IRI to a URI. All non-ASCII and unsafe characters are quoted. If the URL has a domain, it is encoded to Punycode. >>> iri_to_uri('http://\u2603.net/p\xe5th?q=\xe8ry%DF') 'http://xn--n3h.net/p%C3%A5th?q=%C3%A8ry%DF' :param iri: The IRI to convert. :param charset: The encoding of the IRI. :param errors: Error handler to use during ``bytes.encode``. .. versionchanged:: 2.3 Passing a tuple or bytes, and the ``charset`` and ``errors`` parameters, are deprecated and will be removed in Werkzeug 3.0. .. versionchanged:: 2.3 Which characters remain unquoted is specific to each part of the URL. .. versionchanged:: 2.3 The ``safe_conversion`` parameter is deprecated and will be removed in Werkzeug 2.4. .. versionchanged:: 0.15 All reserved characters remain unquoted. Previously, only some reserved characters were left unquoted. .. versionchanged:: 0.9.6 The ``safe_conversion`` parameter was added. .. versionadded:: 0.6 r<r-r.rsr:r;r=rtzRThe 'safe_conversion' parameter is deprecated and will be removed in Werkzeug 3.0.rr z%!$&'()*+,/:;=@)rr+rz%!$&'()*+,/:;=?@z%!#$&'()*+,/:;=?@rFrorprqrrz %!$&'()*+,;=rru)r0r1r2rGr>rrzrIrHrrrJrrrrrrBrRrZrar) irirrsafe_conversion ascii_irirrrrrrU pass_quoteds r%r}r}s"H    #u V  o#u T  jj!  W  "       7+I9??$%* + SME "3gf UD %++$6QW XE 076H ~~&&v.55g> f}VHA zz81UZZL) ~~U^^.9 >>^DKV1[M*D66(# u||VT5(C DDA   s.H,, H98H9c |jdt|jdddk(r|St |S#t$r Yt |SwxYw)aThe URL scheme ``itms-services://`` must contain the ``//`` even though it does not have a host component. There may be other invalid schemes as well. Currently, responses will always call ``iri_to_uri`` on the redirect ``Location`` header, which removes the ``//``. For now, if the IRI only contains ASCII and does not contain spaces, pass it on as-is. In Werkzeug 3.0, this should become a ``response.process_location`` flag. :meta private: rNr )rHrrrJr})rFs r%_invalid_iri_to_urirK s\ 7 syyq! "a 'J c?   c?  s> AAcjtjdtd|ddlm}|}t |t r&t |t s|j|xsd}n5t |tr%t |ts|j|xsd}|t|j||||S)aParse a query string and return it as a :class:`MultiDict`. :param s: The query string to parse. :param charset: Decode bytes to string with this charset. If not given, bytes are returned as-is. :param include_empty: Include keys with empty values in the dict. :param errors: Error handling behavior when decoding bytes. :param separator: Separator character between pairs. :param cls: Container to hold result instead of :class:`MultiDict`. .. deprecated:: 2.3 Will be removed in Werkzeug 3.0. Use ``urllib.parse.parse_qs`` instead. .. versionchanged:: 2.1 The ``decode_keys`` parameter was removed. .. versionchanged:: 0.5 In previous versions ";" and "&" could be used for url decoding. Now only "&" is supported. If you want to use ";", a different ``separator`` can be provided. .. versionchanged:: 0.5 The ``cls`` parameter was added. zr'werkzeug.urls.url_decode' is deprecated and will be removed in Werkzeug 2.4. Use 'urllib.parse.parse_qs' instead.r-r.r  MultiDictr) r0r1r2rrNrGrrIrzrH_url_decode_implr)rr include_emptyr separatorr5rNs r%rere5s@ MM 0  {-!S*Y"<$$W%78 Au jE&B$$W%78  GGI   r$ctjdtdddlm}||||}t ||||} |ddlm} | }|| S)aWorks like :func:`url_decode` but decodes a stream. The behavior of stream and limit follows functions like :func:`~werkzeug.wsgi.make_line_iter`. The generator of pairs is directly fed to the `cls` so you can consume the data while it's parsed. :param stream: a stream with the encoded querystring :param charset: the charset of the query string. If set to `None` no decoding will take place. :param include_empty: Set to `False` if you don't want empty values to appear in the dict. :param errors: the decoding error behavior. :param separator: the pair separator to be used, defaults to ``&`` :param cls: an optional dict class to use. If this is not specified or `None` the default :class:`MultiDict` is used. :param limit: the content length of the URL data. Not necessary if a limited stream is provided. .. deprecated:: 2.3 Will be removed in Werkzeug 2.4. Use ``urllib.parse.parse_qs`` instead. .. versionchanged:: 2.1 The ``decode_keys`` and ``return_iterator`` parameters were removed. .. versionadded:: 0.8 zy'werkzeug.urls.url_decode_stream' is deprecated and will be removed in Werkzeug 2.4. Use 'urllib.parse.parse_qs' instead.r-r.r )make_chunk_iterrM)r0r1r2wsgirSrOrrN) streamrrPrrQr5limitrS pair_iterdecoderrNs r%url_decode_streamrYksVF MM > & 59Iy'=&IG {- w<r$c#K|D][}|st|}|d}||vr|j|d\}}n |s6|}|d}t|||t|||f]yw)Nrr ro)r rr) rWrrPrpairrequalrrs r%rOrOs    &# D=E1-JC CbEE S'6 2 UGV 4   sA"A$ctjdtdt|d}|j t ||||S)aPURL encode a dict/`MultiDict`. If a value is `None` it will not appear in the result string. Per default only values are encoded into the target charset strings. :param obj: the object to encode into a query string. :param charset: the charset of the query string. :param sort: set to `True` if you want parameters to be sorted by `key`. :param separator: the separator to be used for the pairs. :param key: an optional function to be used for sorting. For more details check out the :func:`sorted` documentation. .. deprecated:: 2.3 Will be removed in Werkzeug 2.4. Use ``urllib.parse.urlencode`` instead. .. versionchanged:: 2.1 The ``encode_keys`` parameter was removed. .. versionchanged:: 0.5 Added the ``sort``, ``key``, and ``separator`` parameters. zs'werkzeug.urls.url_encode' is deprecated and will be removed in Werkzeug 2.4. Use 'urllib.parse.urlencode' instead.r-r.r)r0r1r2r rkr)rrrrrQs r% url_encoder^sD6 MM 1   7+I >>*3sC DDr$ctjdtdt|d}t ||||}||St |D])\}}|r|j ||j |+y)aLike :meth:`url_encode` but writes the results to a stream object. If the stream is `None` a generator over all encoded pairs is returned. :param obj: the object to encode into a query string. :param stream: a stream to write the encoded object into or `None` if an iterator over the encoded pairs should be returned. In that case the separator argument is ignored. :param charset: the charset of the query string. :param sort: set to `True` if you want parameters to be sorted by `key`. :param separator: the separator to be used for the pairs. :param key: an optional function to be used for sorting. For more details check out the :func:`sorted` documentation. .. deprecated:: 2.3 Will be removed in Werkzeug 2.4. Use ``urllib.parse.urlencode`` instead. .. versionchanged:: 2.1 The ``encode_keys`` parameter was removed. .. versionadded:: 0.8 zz'werkzeug.urls.url_encode_stream' is deprecated and will be removed in Werkzeug 2.4. Use 'urllib.parse.urlencode' instead.r-r.rN)r0r1r2r r enumeratewrite) rrUrrrrQgenrchunks r%url_encode_streamrdsz< MM ?   7+I 3s 3C ~ n U  LL # U r$ctjdtdt|tr t |}t|tr t |}t ||ft|}|s|S|s|St||\}}}}}t|||\} } } } } | |k7r|S| rt | | | | | fS|} | dd|dk(r| j|d}nP| s|j|d}| s5|} n2|j|ddd| j|dz}|d|d k(r |d |d<|Dcgc]}||d k7s|}} d}t|dz }||kr=|||d k(r$||dz |d |d fvr ||dz |dz=n |dz }||kr=nT|d |d g}|dd|k(r |d=|dd|k(r |dj|} t | | | | | fScc}w) aqJoin a base URL and a possibly relative URL to form an absolute interpretation of the latter. :param base: the base URL for the join operation. :param url: the URL to join. :param allow_fragments: indicates whether fragments should be allowed. .. deprecated:: 2.3 Will be removed in Werkzeug 2.4. Use ``urllib.parse.urljoin`` instead. zo'werkzeug.urls.url_join' is deprecated and will be removed in Werkzeug 2.4. Use 'urllib.parse.urljoin' instead.r-r.)rNr r.roz..) r0r1r2rGr>rmr r rirrrk)baserrrbschemebnetlocbpathbquery bfragmentrrrrrsegmentssegmentrnunwanted_markers r%rjrj s[ MM / $4 #u#dC[!T"A   1: o2.GWeVY-6c7O,T)FFD%   FFD%BCC F BQx1S6::af% ;;qv&E;;qv&s+djj3.@@|qvu (0EG7af3DEHE   MA !e{ag%(1q5/!B%4AQ*QQUQU]+ FA !e  uag&O 2A,/ ) QK 2A,/ ) S6;;x D eX> ??%Fs G>G>cdt|Dcgc] }|d | }}t|d|Scc}w)Nr z !$'()*,/:;?@)rr+)rr)rr+xrs r% _urlencodert\s:)/ D11Q43CQ DE D U( CC Es --)ro)r str | bytesrrurrz) r1t.Mapping[str, str] | t.Iterable[tuple[str, str]]rrrboolr+t.Callable[[tuple[str, str]], t.Any] | Nonerzt.Iterator[str])rrrrrr)NT)rrrrrrwrr')rsrtz/:ro) rrrrrrurrurzt.Callable[[bytes], str]r) rrurrrrrrurrurr)rsrtro) rrrrrrrrrr)rztuple[str, str, str, str, str]rr)rsrAro) rrurrrrrrrrr)rrurrrrrr)rs)rrrrrr)r"rJrztuple[str, int])rrr3rrz t.Callable[[str, str, str], str]r)rD$str | tuple[str, str, str, str, str]rrrrrr)NNN) rFryrrrrrGz bool | Nonerr)rFrrr)rsTrA&N)rzt.AnyStrrrrPrwrrrQrr5type[ds.MultiDict] | Nonerr)rsTrA&NN)rUz t.IO[bytes]rrrPrwrrrQrzr5r{rVrrr) rWzt.Iterable[t.AnyStr]rrrPrwrrrzt.Iterator[tuple[str, str]])rsFNrz) rrvrrrrwrrxrQrrr)NrsFNrz)rrvrUzt.IO[str] | NonerrrrwrrxrQrrNone)T)rhryrryrrwrr)rrvr+rrr)Mr __future__rcodecsrr0typingtr0 urllib.parserrrrr _internalr r r r rr TYPE_CHECKINGrodsr1r_always_safe_charsrrHr _hexdigitsrOrrr  NamedTuplerr'rrrr"rrrYrir_fast_url_quoter rrwrrmrrrr$register_errorr5rzrI_always_unsaferAr@r?rCrr}rKrerYrOr^rdrjrt)arr s000r%rs1 #  "!#'#+,??&RZZ, - +227;< %    c!IWsaS9b11 :?s D$sn##G, D  fifR  ' 8 w B:Cj8Q 5Q>W :W W W 5 W  W<CBF:= := :=:>:= :=|        >'('S=6  *% *% *% *%  *%  *%  *%\NPQ QQ14QGJQQ.%T && & &  &  &>;D++ +47++@#LL*,BC21t1d1D1299;&z>B#G^f-DE"6>E+AB "6>G+CD ZE -ZE ZE ZE ZE~#' xE -xE xE xE! xE  xEv.%) 33 33  3  3 # 33p%)4 4 44  4  4 # 4 44n # .1 BF PS   .7; "E :"E "E "E 5 "E  "E  "EN $7; , :, ,,  , 5 ,  , ,d!N@ .N@ -N@N@ N@dOVD <DHKDDe) Es /K%K+