U
|
Þ=®d² ã @ sú U d dl mZ d dlZd dlZd dlZd dlZd dlmZ ej rLddl
|
m Z G dd de Z G dd d ZG d
|
d d eZG d d d eZG dd deZG dd deZG dd deZG dd deZG dd deZeeeeeeedZded< dS )é )Ú annotationsN)Úquoteé )ÚMapc @ s e Zd ZdZdS )ÚValidationErrorzValidation error. If a rule converter raises this exception the rule
|
does not match the current URL and the next URL is tried.
|
N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__© r r úRd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\werkzeug/routing/converters.pyr s r c sh e Zd ZdZdZdZdZddd fdd Zd
|
dddd d d ZdddddZ dddddZ
|
Z S )Ú BaseConverterzBase class for all converters.
|
|
.. versionchanged:: 2.3
|
``part_isolating`` defaults to ``False`` if ``regex`` contains a ``/``.
|
z[^/]+éd Tút.AnyÚNone)ÚkwargsÚreturnc s2 t jf | d| jkr.d| jkr.d| jk| _d S )NÚregexÚpart_isolatingú/)ÚsuperÚ__init_subclass__Ú__dict__r r )Úclsr ©Ú __class__r r r s z BaseConverter.__init_subclass__r )ÚmapÚargsr r c O s
|
|| _ d S ©N)r )Úselfr r r r r r Ú__init__& s zBaseConverter.__init__Ústr©Úvaluer c C s |S r r ©r r# r r r Ú to_python) s zBaseConverter.to_pythonc C s@ t |ttfr*tjdtdd t|ddS tt|| jj ddS )NzUPassing bytes as a URL value is deprecated and will not be supported in Werkzeug 3.0.é )Ú
|
stacklevelz!$&'()*+,/:;=@)Úsafe)Úencodingr( )
|
Ú
|
isinstanceÚbytesÚ bytearrayÚwarningsÚwarnÚDeprecationWarningr r! r Úcharsetr$ r r r Úto_url, s ü zBaseConverter.to_url) r r r r
|
r Úweightr r r r% r1 Ú __classcell__r r r r r s r c s0 e Zd ZdZd dddddd fd d
|
Z ZS ) ÚUnicodeConvertera This converter is the default converter and accepts any string but
|
only one path segment. Thus the string can not include a slash.
|
|
This is the default validator.
|
|
Example::
|
|
Rule('/pages/<page>'),
|
Rule('/<string(length=2):lang_code>')
|
|
:param map: the :class:`Map`.
|
:param minlength: the minimum length of the string. Must be greater
|
or equal 1.
|
:param maxlength: the maximum length of the string.
|
:param length: the exact length of the string.
|
r Nr Úintú
|
int | Noner )r Ú minlengthÚ maxlengthÚlengthr c sf t |¡ |d k r&dt| d}n0|d kr4d}n tt|}dt| d| d}d| | _d S )NÚ{Ú}Ú ú,z[^/])r r r5 r! r )r r r7 r8 r9 Z length_regexZmaxlength_valuer r r r L s zUnicodeConverter.__init__)r NN)r r r r
|
r r3 r r r r r4 : s
|
ûr4 c s: e Zd ZdZdddd fdd Zddd d
|
d Z ZS ) Ú AnyConvertera Matches one of the items provided. Items can either be Python
|
identifiers or strings::
|
|
Rule('/<any(about, help, imprint, class, "foo,bar"):page_name>')
|
|
:param map: the :class:`Map`.
|
:param items: this function accepts the possible items as positional
|
arguments.
|
|
.. versionchanged:: 2.2
|
Value is validated when building a URL.
|
r r! r )r Úitemsr c s8 t |¡ t|| _dd dd |D ¡ d| _d S )Nz(?:ú|c S s g | ]}t |¡qS r )ÚreÚescape)Ú.0Úxr r r Ú
|
<listcomp>p s z)AnyConverter.__init__.<locals>.<listcomp>ú))r r Úsetr? Újoinr )r r r? r r r r m s
|
zAnyConverter.__init__r r" c C sD || j krt|S d dd t| j D ¡}td| d| d S )Nz, c s s | ]}d | d V qdS )ú'Nr )rC Úitemr r r Ú <genexpr>v s z&AnyConverter.to_url.<locals>.<genexpr>rI z' is not one of )r? r! rH ÚsortedÚ
|
ValueError)r r# Z valid_valuesr r r r1 r s
|
zAnyConverter.to_url)r r r r
|
r r1 r3 r r r r r> _ s r> c @ s e Zd ZdZdZdZdS )Ú PathConverterzñLike the default :class:`UnicodeConverter`, but it also matches
|
slashes. This is useful for wikis and similar applications::
|
|
Rule('/<path:wikipage>')
|
Rule('/<path:wikipage>/edit')
|
|
:param map: the :class:`Map`.
|
z[^/].*?éÈ N)r r r r
|
r r2 r r r r rN z s rN c sv e Zd ZU dZdZeZded< ddd d
|
d
|
d d d fdd ZdddddZ dddddZ
|
e ddddZ Z S )ÚNumberConverterzKBaseclass for `IntegerConverter` and `FloatConverter`.
|
|
:internal:
|
é2 z
|
t.CallableÚ num_convertr NFr r5 r6 Úboolr )r Ú fixed_digitsÚminÚmaxÚsignedr c s4 |r | j | _t |¡ || _|| _|| _|| _d S r )Ú signed_regexr r r rT rU rV rW )r r rT rU rV rW r r r r s zNumberConverter.__init__r! r r" c C sV | j rt|| j krt | |¡}| jd k r8|| jk sL| jd k rR|| jkrRt |S r )rT Úlenr rR rU rV r$ r r r r% ¡ s
|
ÿÿzNumberConverter.to_pythonc C s$ t | |¡}| jr | | j¡}|S r )r! rR rT Úzfillr$ r r r r1 « s zNumberConverter.to_url)r c C s d| j S )Nz-?)r )r r r r rX ± s z NumberConverter.signed_regex)r NNF)r r r r
|
r2 r5 rR Ú__annotations__r r% r1 ÚpropertyrX r3 r r r r rP s
|
ú
|
rP c @ s e Zd ZdZdZdS )ÚIntegerConvertera This converter only accepts integer values::
|
|
Rule("/page/<int:page>")
|
|
By default it only accepts unsigned, positive values. The ``signed``
|
parameter will enable signed, negative values. ::
|
|
Rule("/page/<int(signed=True):page>")
|
|
:param map: The :class:`Map`.
|
:param fixed_digits: The number of fixed digits in the URL. If you
|
set this to ``4`` for example, the rule will only match if the
|
URL looks like ``/0001/``. The default is variable length.
|
:param min: The minimal value.
|
:param max: The maximal value.
|
:param signed: Allow signed (negative) values.
|
|
.. versionadded:: 0.15
|
The ``signed`` parameter.
|
z\d+N)r r r r
|
r r r r r r] ¶ s r] c s8 e Zd ZdZdZeZd dddddd fd
|
d Z ZS ) ÚFloatConverteraù This converter only accepts floating point values::
|
|
Rule("/probability/<float:probability>")
|
|
By default it only accepts unsigned, positive values. The ``signed``
|
parameter will enable signed, negative values. ::
|
|
Rule("/offset/<float(signed=True):offset>")
|
|
:param map: The :class:`Map`.
|
:param min: The minimal value.
|
:param max: The maximal value.
|
:param signed: Allow signed (negative) values.
|
|
.. versionadded:: 0.15
|
The ``signed`` parameter.
|
z\d+\.\d+NFr z float | NonerS r )r rU rV rW r c s t j||||d d S )N)rU rV rW )r r )r r rU rV rW r r r r å s zFloatConverter.__init__)NNF) r r r r
|
r ÚfloatrR r r3 r r r r r^ Ï s ûr^ c @ s4 e Zd ZdZdZdddddZddddd Zd
|
S ) Ú UUIDConverterzThis converter only accepts UUID strings::
|
|
Rule('/object/<uuid:identifier>')
|
|
.. versionadded:: 0.10
|
|
:param map: the :class:`Map`.
|
zK[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}r! z uuid.UUIDr" c C s
|
t |¡S r )ÚuuidÚUUIDr$ r r r r% þ s zUUIDConverter.to_pythonc C s t |S r )r! r$ r r r r1 s zUUIDConverter.to_urlN)r r r r
|
r r% r1 r r r r r` ï s
|
|
ÿr` )ÚdefaultÚstringÚanyÚpathr5 r_ ra z#t.Mapping[str, type[BaseConverter]]ÚDEFAULT_CONVERTERS)Ú
|
__future__r rA ÚtypingÚtra r- Ú urllib.parser Ú TYPE_CHECKINGr r rM r r r4 r> rN rP r] r^ r` rg r[ r r r r Ú<module> s2 '%. ù
|
