a -=ic @s8UdZddlZddlZddlZddlZddlmZddlmZddlm Z ddlm Z ddlm Z ej rtdd l mZed Zeed Zd Zd deDZddedDZGdddejZGdddeZGdddeZGdddeZeeiZejej e!eje"e!ffe#d<dlej$e%e"fej$e%e"fe"dddZ&ej$ej'e%e%fej(ej)e%e%ffe%e*ej+ej,ej)e%e%fgej-fej.e%dd d!Z/dme%e%e%d"d#d$Z0dne%ej+e%e*ed&d'd(Z1doe%e%ej$e%e"fej$e%e"fej,e"ge%fd,d-d.Z2e2Z3e2d/d0d1Z4e"e%d2d3d4Z5dpej$e%e"fe%e%ej$e%e"fej$e%e"fe%d5d6d7Z6dqe%e%e%e%e%d8d9d:Z7ej)e%e%e%e%e%fe%d;dej)e%e!fdJdKdLZ?e@dMe?duej$e%ej)e%e%e%e%e%ffe%e%e%dNdOdPZAdQZBdvej$e%ej)e%e%e%e%e%ffe%e%e*e%dSdTdUZCdwejDe%e*e%e%ej+ejEdWdXdYdZd[ZFdxejGe"e%e*e%e"ej+ejEdWej+e!dXd]d^d_ZHej(ejDe%e*e%ej.ej)e%e%fd`dadbZIdyej$ej'e%e%fej(ej)e%e%ffe%e*ej+ej,ej)e%e%fgej-fe%e%dcdddeZJdzej$ej'e%e%fej(ej)e%e%ffej+ejGe%e%e*ej+ej,ej)e%e%fgej-fe%ddfdgdhZKd{ej$e%ej)e%e%e%e%e%ffej$e%ej)e%e%e%e%e%ffe*e%didjdkZLdS)|zFunctions for working with URLs. Contains implementations of functions from :mod:`urllib.parse` that handle bytes and strings. N)_check_str_tuple) _decode_idna) _encode_idna)_make_encode_wrapper)_to_str)datastructuresz^[a-zA-Z0-9+-.]+$sKabcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~$!'()*+,;0123456789ABCDEFabcdefcCs8i|]0}tD]&}||dt||dq qS)ascii) _hexdigitsencodeint).0abr^/home/droni/.local/share/virtualenvs/DPS-5Je3_V2c/lib/python3.9/site-packages/werkzeug/urls.py #srcCsg|]}d|ddqS)%02Xr )r )rcharrrr (rc@s6eZdZUeed<eed<eed<eed<eed<dS) _URLTupleschemenetlocpathqueryfragmentN)__name__ __module__ __qualname__str__annotations__rrrrr+s rc@seZdZUdZdZeed<eed<eed<eed<eddd Zej dd d d Z e ej edd dZ e ej edddZe ej edddZe ej edddZe ej edddZe ej edddZe ej edddZe ej edddZej ej dddd Zej ej ddd!d"Zedd#d$Zedd%d&Zedd'd(Zddd)d*Zddd+d,Zd7ej eejej eej efd.d/d0Zejej eefdd1d2Zejej eej efdd3d4Z ejej eej efdd5d6Z!d-S)8BaseURLz7Superclass of :py:class:`URL` and :py:class:`BytesURL`.r_at_colon _lbracket _rbracketreturncCs|SN)to_urlselfrrr__str__<szBaseURL.__str__)kwargsr,cKs|jfi|S)zReturn an URL with the same values, except for those parameters given new values by whichever keyword arguments are specified.)_replace)r0r2rrrreplace?szBaseURL.replacecCs |dS)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/rrrhostDsz BaseURL.hostcCsP|j}|durDt|trDz t|}WntyB|dd}Yn0t|ddS)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. Nr ignore)r6 isinstancer$r UnicodeErrorr rr0rvrrr ascii_hostLs  zBaseURL.ascii_hostc CsRz6tt|d}d|kr*dkr4nn|WSWnttfyLYn0dS)z}The port in the URL as an integer if it was present, `None` otherwise. This does not fill in default ports. rriN)rrr5 ValueError TypeErrorr:rrrport[s z BaseURL.portcCs |dS)zSThe authentication part in the URL if available, `None` otherwise. r) _split_netlocr/rrrauthhsz BaseURL.authcCs |d}|durt|SdS)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_legacyr:rrrusernameos zBaseURL.usernamecCs |dS)zThe username if it was part of the URL, `None` otherwise. Unlike :attr:`username` this one is not being decoded. rrCr/rrr raw_usernameyszBaseURL.raw_usernamecCs |d}|durt|SdS)zThe password if it was part of the URL, `None` otherwise. This undergoes URL decoding and will always be a string. rNrBr:rrrpasswords zBaseURL.passwordcCs |dS)zThe password if it was part of the URL, `None` otherwise. Unlike :attr:`password` this one is not being decoded. rrFr/rrr raw_passwordszBaseURL.raw_passwordds.MultiDict[str, str])argsr2r,cOst|jg|Ri|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_decoderr0rKr2rrr decode_queryszBaseURL.decode_querycOstt|g|Ri|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_joinrMrrrjoinsz BaseURL.joincCst|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/rrrr.szBaseURL.to_urlc Cs|jpd}d|vrd|d}|j}|dur:|d|}dtdt|jpLddddt|jp^ddddg}|r|d |}|S) z6Encodes the netloc part to an ASCII safe URL as bytes.:[]Nutf-8strictz/:%@)r<r?rQfilter url_quoterGrIr0r;r?rArrr encode_netlocs"   zBaseURL.encode_netloccCst|jp d}d|vr"d|d}|j}|dur>|d|}dtdt|jpPddt|jp^ddg}|r||d|}|S)z&Decodes the netloc part into a string.rSrTrUrVNz/:%@rY)rr6r?rQrZrDrGrIr\rrr decode_netlocs"  zBaseURL.decode_netloccCs 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. )rO iri_to_urir/rrr to_uri_tupleszBaseURL.to_uri_tuplecCs 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. )rO uri_to_irir/rrr to_iri_tuples zBaseURL.to_iri_tupleN) pathformatr,cCs:|jdkrdSt|j}|jp d}|dur>tjdkr:d}nd}|dkr|dddkr|dd r|d d d vr|dd d |d d}|dd d v}ddl}||}|r|dur| d dd}t |d kr|\}}n |d}d}n,|dkrddl }||}nt d||dvr2d}||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/z|:rT)z\\\z///r\rSzInvalid path format )z 127.0.0.1z::1 localhost)r url_unquoterrosnameisalphantpathnormpathlstripsplitlen posixpathr>)r0rcrr6Z windows_sharerrpartsrwrrrget_file_locations6    0       zBaseURL.get_file_locationcCs2|j|jvr(|j|j\}}}||fSd|jfSr-)r'r partition)r0rA_rrrrr@$s zBaseURL._split_netloccCs@|d}|sdS|j|vr&|dfS||j\}}}||fS)Nrre)r@r(rz)r0rArEr{rHrrrrC*s  zBaseURL._split_authcCs|d}|sdS||jsL|j|vrD||j\}}}||fS|dfS||j}|dkrh|dfS|d|}||dd}||jr||ddfS|dfS)Nrrer)r@ startswithr)r(rzfindr*)r0r;r6r{r?idxrestrrrr54s       zBaseURL._split_host)N)"r!r"r#__doc__ __slots__r$r%r1tAnyr4propertyOptionalr6r<rr?rArErGrHrIrNrQr.r]r^r`rbTupleryr@rCr5rrrrr&3sN       >$ r&c@s8eZdZdZdZdZdZdZdZde e d d d d Z d S)URLzRepresents a parsed URL. This behaves like a regular tuple but also has some extra attributes that give further insight into the URL. rrYrTrUrVrWr4BytesURLcharseterrorsr,c Cs:t|jd||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 )rrr r]rrr r0rrrrrr Vs    z URL.encodeN)rWr4) r!r"r#rrr'r(r)r*r$r rrrrrJsrc@sTeZdZdZdZdZdZdZdZe ddd Z e dd d Z de e ddddZ dS)rz!Represents a parsed URL in bytes.r@:[]r+cCs|ddS)NrWr4)r.decoder/rrrr1lszBytesURL.__str__cCs|jS)z&Returns the netloc unchanged as bytes.)rr/rrrr]oszBytesURL.encode_netlocrWr4rrc Cs:t|jd||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 )rrrr^rrr rrrrrss    zBytesURL.decodeN)rWr4)r!r"r#rrr'r(r)r*r$r1bytesr]rrrrrrcsr _unquote_mapsrS)stringunsafer,cst|tr|d}ttr(dttt|d}tt|d}z t}Wn0t yfddt D}t<Yn0|D]N}|dd}||vr| ||| |ddq| d| |qt|S)NrW%rcsi|]\}}|vr||qSrr)rhrrrrrsz%_unquote_to_bytes..rj%)r8r$r frozenset bytearrayiterrunextrKeyError _hextobyteitemsappendextendr)rrgroupsresultZ hex_to_bytegroupcoderrr_unquote_to_bytess*           r)objrsortkeyr,c csddlm}||}|r$t||d}|D]f\}}|dur:q(t|tsTt||}n|}t|tsrt||} n|} t|dt| Vq(dS)Nr)iter_multi_items)r=)rrsortedr8rr$r _fast_url_quote_plus) rrrrriterablekey_strZ value_str key_bytesZ value_bytesrrr_url_encode_impls     r)valuerr,cCs8zt|dd|dWSty2t|d|dYS0dS)NrWrX)rrrlatin1)rr)rnr9)rrrrrrDs rDT)urlrallow_fragmentsr,c st|t|t}|dur"d}d}}}|d}|dkrtt|d|ddr||dd}|rtfdd |Dr|d||}}|dd d krFt |} d D]"} || d } | dkrt | | } q|d | || d}}d |vr"d|vs>d|vrFd |vrFt d|rnd|vrn| dd\}}d|vr| dd\}}|rt nt} | |||||S)aParses a URL from a string into a :class:`URL` tuple. If the URL is lacking a scheme it can be provided as second argument. Otherwise, it is ignored. Optionally fragments can be stripped from the URL by setting `allow_fragments` to `False`. The inverse of this function is :func:`url_unparse`. :param url: the URL to parse. :param scheme: the default schema to use if the URL is schemaless. :param allow_fragments: if set to `False` a fragment will be removed from the URL. NrSrTrr4)rrc3s|]}|dvVqdS) 0123456789Nrrcsrr rzurl_parse..rj//z/?#rUrVzInvalid IPv6 URL#?)rr8r$r} _scheme_rematchranylowerrvminr=rurr) rrrZ is_text_basedrrr irdelimrwdelimZ result_typerrrrOs: "     rOrWrX/:)rrsaferr,csvttr||t|tr,|||}tttBtt|fddtdDttdfdd }|S)aPrecompile the translation table for a URL encoding function. Unlike :func:`url_quote`, the generated function only takes the string to quote. :param charset: The charset to encode the result with. :param errors: How to handle encoding errors. :param safe: An optional sequence of safe characters to never encode. :param unsafe: An optional sequence of unsafe characters to always encode. cs(g|] }|vrt|n d|dqS)rr)chrrrrrrrz(_make_fast_url_quote..rrr,csdfdd|DS)NrScsg|] }|qSrrrtablerrrrz7_make_fast_url_quote..quote..)rQrrrrquotesz#_make_fast_url_quote..quote)r8r$r rr _always_saferanger)rrrrrr)rrr_make_fast_url_quotes    r +)rrrcCst|ddS)Nrr)_fast_quote_plusr4rrrrrsr)rrrrrr,cCst|tttfst|}t|tr.|||}t|trD|||}t|trZ|||}tt|tBtt|}t}t|D]&}||vr||q|t |qt| |S)aDURL 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. .. versionadded:: 0.9.2 The `unsafe` parameter was added. ) r8r$rrr rrrr _bytetohexr)rrrrrr;rrrrr[#s        r[)rrrrr,cCst||||ddddS)zURL 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. rr)r[r4)rrrrrrrurl_quote_plusFs r) componentsr,cCst||\}}}}}t|}|d}|s<|rz||drz|r`|dd|dkr`|d|}|d|pp|d|}n |r||7}|r||d|}|r||d|}|r||d|}|S) zThe 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. rSriNrrrTrr)rrr|)rrrrrr rrrrrrRSs" rRr4)rrrrr,cCs"t||}|dur|S|||S)afURL 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. N)rr)rrrrr;rrrrnrs rn)rrrr,cCs0t|tr|dd}n |dd}t|||S)aURL 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. rr+ )r8r$r4rn)rrrrrrurl_unquote_pluss  r)rrr,cCst||ddd}|drP|ddrP|dddvrPd |dd }t|}t|j|d d }t|j|d d }t|j |d d }t |j | |||fS)aSometimes 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. r4rlrizfile:// )z:/z|/zfile:///Nz /%+$!*'(),rz :&%=+$!*'(),) rr4r|rqrOr[rrrr rRrr])rrrrqsanchorrrrurl_fixs*rcCsg|]}|tvrt|qSr)rrrrrrrr)er,cCs t|j|j|j}||jfS)zRUsed in :func:`uri_to_iri` after unquoting to re-quote any invalid bytes. )_fast_url_quoteobjectstartend)routrrr_codec_error_url_quotesrwerkzeug.url_quote)urirrr,cCsht|trt|}tt||}t|j||t}t|j||t}t|j ||t}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:: 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 ) r8tuplerRrOrrnr_to_iri_unsaferr rr^)rrrrrr rrrras raz:/?#[]@!$&'()*+,;=%F)irirrsafe_conversionr,c Cst|trt|}|rVz,t|}|d}t|dkr@|WSWntyTYn0tt|||}t |j ||t }t |j ||t }t |j ||t }t|j||||fS)aConvert 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``. :param safe_conversion: Return the URL unchanged if it only contains ASCII characters and no whitespace. See the explanation below. There is a general problem with IRI conversion with some protocols that are in violation of the URI specification. Consider the following two IRIs:: magnet:?xt=uri:whatever itms-services://?action=download-manifest After parsing, we don't know if the scheme requires the ``//``, which is dropped if empty, but conveys different meanings in the final URL if it's present or not. In this case, you can use ``safe_conversion``, which will return the URL unchanged if it only contains ASCII characters and no whitespace. This can result in a URI with unquoted characters if it was not already quoted correctly, but preserves the URL's semantics. Werkzeug uses this for the ``Location`` header for redirects. .. 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)r8rrRrr rvrur9rOr[r _to_uri_saferr rr]) rrrrZ native_iriZ ascii_irirrr rrrr_s+    r_&z ds.MultiDictrJ)rr include_emptyr separatorclsr,cCsv|durddlm}|}t|trddlm} | }|| S)a_Works 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. .. versionchanged:: 2.0 The ``decode_keys`` and ``return_iterator`` parameters are deprecated and will be removed in Werkzeug 2.1. .. versionadded:: 0.8 r)make_chunk_iterNr)Zwsgirrrr) rrrrrrrr pair_iterdecoderrrrrurl_decode_stream`s!   r)rrrrr,c csj|D]`}|sqt|}|d}||vr8||d\}}n|s>q|}|d}t|||t|||fVqdS)NrrrS)rrur) rrrrpairrequalrrrrrrs  r)rrrrrr,cCst|d}|t||||S)aURL 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. .. versionchanged:: 2.0 The ``encode_keys`` parameter is deprecated and will be removed in Werkzeug 2.1. .. versionchanged:: 0.5 Added the ``sort``, ``key``, and ``separator`` parameters. r )rrQr)rrrrrrrr url_encodes r)rrrrrrr,c CsRt|d}t||||}|dur$|St|D] \}}|rB||||q,dS)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. .. versionchanged:: 2.0 The ``encode_keys`` parameter is deprecated and will be removed in Werkzeug 2.1. .. versionadded:: 0.8 r N)rr enumeratewrite) rrrrrrgenr~chunkrrrurl_encode_streams   r)baserrr,cst|trt|}t|tr$t|}t||ft||s@|S|sH|St||d\}}}}}t|||\}} } } } ||kr|S| rt|| | | | fS|} | dddkr| d} n@| s|d} | s|} n$|ddd| d} | ddkrd| d<fdd | D} d}t| d}||kr| |d kr| |ddd fvr| |d|d=q.|d7}q>qq.dd g}| dd |kr| d=qd| } t|| | | | fS) a Join 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. )rNrri.rScsg|]}|dkr|qS)r r)rsegmentrrrrrzurl_join..z..rj) r8rrRrrrOrurvrQ)rrrbschemebnetlocbpathbquery bfragmentrrrrr segmentsrnZunwanted_markerrrrrPsT   $   0  rP)rS)rS)NT)rWrXrrS)rWrXrrS)rWrXrS)rWr4rS)rWr4)rW)rWr)rWrXF)rWTr4rN)rWTr4rNN)rWFNr)NrWFNr)T)Mrcodecsroretypingr _internalrrrrr TYPE_CHECKINGrSrZdscompilerrrrr rrr NamedTuplerr&rrrDict FrozenSetrrr%Unionr$rMappingIterablerboolrCallablerIteratorrrDrOrrrrr[rrRrnrrrQrr9rregister_errorrarr_AnyStrTyperLIOrrrrrPrrrrsl        , "&    4        $ !     # D / / &  &  *