U d@sUddlmZddlZddlZddlZddlZddlmZej rLddl m Z Gddde Z Gdd d ZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZeeeeeeedZded<dS)) annotationsN)quote)Mapc@seZdZdZdS)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 ?/tmp/pip-unpacked-wheel-m99gisyz/werkzeug/routing/converters.pyr srcsheZdZdZdZdZdZdddfdd 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[^/]+dTt.AnyNone)kwargsreturnc s2tjf|d|jkr.d|jkr.d|jk|_dS)Nregexpart_isolating/)super__init_subclass____dict__rr)clsr __class__r r rszBaseConverter.__init_subclass__r)mapargsrrcOs ||_dSN)r)selfrrrr r r __init__&szBaseConverter.__init__strvaluercCs|Srr rr#r r r to_python)szBaseConverter.to_pythoncCs@t|ttfr*tjdtddt|ddStt||jj ddS)NzUPassing bytes as a URL value is deprecated and will not be supported in Werkzeug 3.0.) stacklevelz!$&'()*+,/:;=@)safe)encodingr() isinstancebytes bytearraywarningswarnDeprecationWarningrr!rcharsetr$r r r to_url,s zBaseConverter.to_url) rrr r rweightrrr r%r1 __classcell__r r rr r sr cs0eZdZdZd ddddddfd d ZZS) UnicodeConverteraThis 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/'), Rule('/') :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. rNrint int | Noner)r minlength maxlengthlengthrcsft||dk r&dt|d}n0|dkr4d}n tt|}dt|d|d}d||_dS)N{},z[^/])rr r5r!r)rrr7r8r9Z length_regexZmaxlength_valuerr r r Ls  zUnicodeConverter.__init__)rNN)rrr r r r3r r rr r4:s r4cs:eZdZdZddddfdd Zddd d d ZZS) AnyConverteraMatches one of the items provided. Items can either be Python identifiers or strings:: Rule('/') :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. rr!r)ritemsrcs8t|t||_dddd|Dd|_dS)Nz(?:|cSsg|]}t|qSr )reescape).0xr r r psz)AnyConverter.__init__..))rr setr?joinr)rrr?rr r r ms  zAnyConverter.__init__rr"cCsD||jkrt|Sdddt|jD}td|d|dS)Nz, css|]}d|dVqdS)'Nr )rCitemr r r vsz&AnyConverter.to_url..rIz' is not one of )r?r!rHsorted ValueError)rr#Z valid_valuesr r r r1rs zAnyConverter.to_url)rrr r r r1r3r r rr r>_s r>c@seZdZdZdZdZdS) PathConverterzLike the default :class:`UnicodeConverter`, but it also matches slashes. This is useful for wikis and similar applications:: Rule('/') Rule('//edit') :param map: the :class:`Map`. z[^/].*?N)rrr r rr2r r r r rNzs rNcsveZdZUdZdZeZded<ddd d d d d d fdd ZdddddZ dddddZ e ddddZ Z S)NumberConverterzKBaseclass for `IntegerConverter` and `FloatConverter`. :internal: 2z t.Callable num_convertrNFrr5r6boolr)r fixed_digitsminmaxsignedrcs4|r |j|_t|||_||_||_||_dSr) signed_regexrrr rTrUrVrW)rrrTrUrVrWrr r r s zNumberConverter.__init__r!rr"cCsV|jrt||jkrt||}|jdk r8||jksL|jdk rR||jkrRt|Sr)rTlenrrRrUrVr$r r r r%s zNumberConverter.to_pythoncCs$t||}|jr ||j}|Sr)r!rRrTzfillr$r r r r1s zNumberConverter.to_url)rcCs d|jS)Nz-?)r)rr r r rXszNumberConverter.signed_regex)rNNF)rrr r r2r5rR__annotations__r r%r1propertyrXr3r r rr rPs   rPc@seZdZdZdZdS)IntegerConverteraThis converter only accepts integer values:: Rule("/page/") By default it only accepts unsigned, positive values. The ``signed`` parameter will enable signed, negative values. :: Rule("/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)rrr r rr r r r r]sr]cs8eZdZdZdZeZd dddddd fd d ZZS) FloatConverteraThis converter only accepts floating point values:: Rule("/probability/") By default it only accepts unsigned, positive values. The ``signed`` parameter will enable signed, negative values. :: Rule("/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+NFrz float | NonerSr)rrUrVrWrcstj||||ddS)N)rUrVrW)rr )rrrUrVrWrr r r szFloatConverter.__init__)NNF) rrr r rfloatrRr r3r r rr r^sr^c@s4eZdZdZdZdddddZddddd Zd S) UUIDConverterzThis converter only accepts UUID strings:: Rule('/object/') .. 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"cCs t|Sr)uuidUUIDr$r r r r%szUUIDConverter.to_pythoncCst|Sr)r!r$r r r r1szUUIDConverter.to_urlN)rrr r rr%r1r r r r r`s  r`)defaultstringanypathr5r_raz#t.Mapping[str, type[BaseConverter]]DEFAULT_CONVERTERS) __future__rrAtypingtrar- urllib.parser TYPE_CHECKINGrrrMrr r4r>rNrPr]r^r`rgr[r r r r s2   '%.