o ȳgL`@shdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z ddl mZddlmZejr=dd lmZed ZGd d d eZGd ddeZGdddeZGdddeZGdddeZejdejdZGdddeZGdddeZGdddeZGdddeZ Gdd d eZ!Gd!d"d"eZ"Gd#d$d$e"Z#Gd%d&d&e!Z$dS)'z-Validation classes for various types of data.) annotationsN)ABCabstractmethod) zip_longest) attrgetter)ValidationError)ChangedInMarshmallow4Warning)types_Tc@s@eZdZUdZdZded<dddZdd d Zedd dZ dS) ValidatorzAbstract base class for validators. .. note:: This class does not provide any validation behavior. It is only used to add a useful `__repr__` implementation for validators. N str | NoneerrorreturnstrcCs8|}|r |dnd}d|jjd|d|jdS)N, <(zerror=z)>) _repr_args __class____name__r )selfargsrP/var/www/html/chatdoc2/venv/lib/python3.10/site-packages/marshmallow/validate.py__repr__szValidator.__repr__cCsdS)zbA string representation of the args passed to this validator. Used by `__repr__`. rrrrrrr%szValidator._repr_argsvalue typing.AnycCdSNrrrrrr__call__+zValidator.__call__rrrrrr) r __module__ __qualname____doc__r __annotations__rrrr"rrrrr s    r c@s8eZdZdZdZdddd d Zdd dZdddZdS)Anda3Compose multiple validators and combine their error messages. Example: :: from marshmallow import validate, ValidationError def is_even(value): if value % 2 != 0: raise ValidationError("Not an even value.") validator = validate.And(validate.Range(min=0), is_even) validator(-1) # ValidationError: ['Must be greater than or equal to 0.', 'Not an even value.'] :param validators: Validators to combine. :param error: Error message to use when a validator returns ``False``. zInvalid value.Nr validatorstypes.Validatorr r cGst||_|p |j|_dSr )tupler,default_error_messager )rr r,rrr__init__Fs z And.__init__rrcC d|jS)Nz validators=)r,rrrrrJ zAnd._repr_argsrrc Csg}i}|jD]I}z||}t|ts$|dur$tjdtddt|jWqtyP}z||j t|j t r@| |j n| |j WYd}~qd}~ww|r[t|fi||S)NFzTReturning `False` from a validator is deprecated. Raise a `ValidationError` instead.) stacklevel)r, isinstancer warningswarnrrr updatekwargsmessagesdictappendextend)rrerrorsr9 validatorrerrrrrr"Ms.     z And.__call__)r,r-r r r$r%)rr&r'r(r/r0rr"rrrrr*/s  r*c@sfeZdZdZGdddZeZdZhdZdddddd dddZdddZ dddZ dddZ dS) URLaValidate a URL. :param relative: Whether to allow relative URLs. :param absolute: Whether to allow absolute URLs. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}`. :param schemes: Valid schemes. By default, ``http``, ``https``, ``ftp``, and ``ftps`` are allowed. :param require_tld: Whether to reject non-FQDN hostnames. c@s(eZdZddZdd d Zdd d Zd S)zURL.RegexMemoizercCs i|_dSr ) _memoizedrrrrr0ss zURL.RegexMemoizer.__init__relativeboolabsolute require_tldrtyping.PatterncCstgd}|s |dddddd|dd f}d }|r+|r&d |d |f}n d |f}nd ||f}td|tjS)N)zM(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.)+(?:[A-Z]{2,6}\.?|[A-Z0-9-]{2,}\.?) localhostz"\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}z\[[A-F0-9]*:[A-F0-9:]+\]z+(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.?)rz(?:[a-z0-9\.\-\+]*)://z1(?:(?:[a-z0-9\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?z(?:|)z (?::\d+)?z(?:/?|[/?]\S+)\Zz^(z)?^)r<joinrecompile IGNORECASE)rrDrFrGhostname_variants absolute_part relative_partpartsrrr_regex_generatorvs.   z"URL.RegexMemoizer._regex_generatorcCs4|||f}||jvr|j|||d|j|<|j|S)NrDrFrG)rCrU)rrDrFrGkeyrrrr"s   zURL.RegexMemoizer.__call__N)rDrErFrErGrErrH)rr&r'r0rUr"rrrr RegexMemoizerrs 6rXzNot a valid URL.>ftpftpshttphttpsFTN)rDrFschemesrGr rDrErFr]types.StrSequenceOrSet | NonerGr r cCs>|s|std||_||_|p|j|_|p|j|_||_dS)Nz>URL validation cannot set both relative and absolute to False.) ValueErrorrDrFdefault_messager default_schemesr]rG)rrDrFr]rGr rrrr0s    z URL.__init__rrcCd|jd|jS)Nz relative=z , absolute=)rDrFrrrrrzURL._repr_argscC|jj|dSN)inputr formatr!rrr _format_errorzURL._format_errorrcCs||}|s t|d}d|vr#|dd}||jvr#t||j|j|j|jd}|dkrB| drB| | ddd}n| |}|sMt||S)Nz://rrVfilezfile:///zfile://localhost/) rirsplitlowerr]_regexrDrFrG startswithsearchreplace)rrmessageschemeregexmatchedrrrr"s"    z URL.__call__) rDrErFrEr]r^rGrEr r r$rrrr) rr&r'r(rXror`rar0rrir"rrrrrBfs E  rBc@sdeZdZdZedejejBZedejejBZ dZ dZ dddd d Z dddZ dddZdS)EmailzValidate an email address. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}`. z(^[-!#$%&'*+/=?^`{}|~\w]+(\.[-!#$%&'*+/=?^`{}|~\w]+)*\Z|^"([\001-\010\013\014\016-\037!#-\[\]-\177]|\\[\001-\011\013\014\016-\177])*"\Z)z(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.)+(?:[A-Z]{2,6}|[A-Z0-9-]{2,})\Z|^\[(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\]\Z)rIzNot a valid email address.Nr+r r cCs|p|j|_dSr )r`r )rr rrrr0szEmail.__init__rrrcCrdrergr!rrrrirjzEmail._format_errorcCs||}|r d|vrt||dd\}}|j|s!t|||jvrO|j|sOz |dd}Wn t yBYt|w|j|rK|St||S)N@rlidnaascii) rirrsplit USER_REGEXmatchDOMAIN_WHITELIST DOMAIN_REGEXencodedecode UnicodeError)rrrs user_part domain_partrrrr"s$       zEmail.__call__r r rw)rr&r'r(rNrOrPUNICODEr}rrr`r0rir"rrrrrxs    rxc@sdeZdZdZdZdZdZdZdZdZ dZ dd d d d dddZ d ddZ d!ddZ d"ddZd S)#Rangea-Validator which succeeds if the value passed to it is within the specified range. If ``min`` is not specified, or is specified as `None`, no lower bound exists. If ``max`` is not specified, or is specified as `None`, no upper bound exists. The inclusivity of the bounds (if they exist) is configurable. If ``min_inclusive`` is not specified, or is specified as `True`, then the ``min`` bound is included in the range. If ``max_inclusive`` is not specified, or is specified as `True`, then the ``max`` bound is included in the range. :param min: The minimum value (lower bound). If not provided, minimum value will not be checked. :param max: The maximum value (upper bound). If not provided, maximum value will not be checked. :param min_inclusive: Whether the `min` bound is included in the range. :param max_inclusive: Whether the `max` bound is included in the range. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}`, `{min}` and `{max}`. zMust be {min_op} {{min}}.zMust be {max_op} {{max}}.z.Must be {min_op} {{min}} and {max_op} {{max}}.zgreater than or equal toz greater thanzless than or equal toz less thanNT) min_inclusive max_inclusiver rrErr r cCs||_||_||_||_||_|jj|jr|jn|jd|_|j j|jr'|j n|j d|_ |j j|jr6|jn|j|jr>|j n|j d|_ dS)N)min_op)max_op)rr) minmaxr rr message_minrh message_gte message_gt message_max message_lte message_lt message_all)rrrrrr rrrr0Js  zRange.__init__rrcCs$d|jd|jd|jd|jS)Nmin=, max=z, min_inclusive=z, max_inclusive=)rrrrrrrrres$zRange._repr_argsrr rscCs|jp|j||j|jdS)N)rfrr)r rhrrrrrsrrrrihszRange._format_errorcCs|jdur&|jr||jkr&n||jkr&|jdur|jn|j}t||||jdurL|jr4||jkrLn||jkrL|jdurA|jn|j}t||||Sr ) rrrrrrrirrrrrrr"ks  zRange.__call__NN)rrErrEr r r$)rr rsrrrrr rr )rr&r'r(rrrrrrrr0rrir"rrrrr.s&  r_SizedT)boundc@sVeZdZdZdZdZdZdZ  dddddddZdddZ dddZ dddZ dS) LengthahValidator which succeeds if the value passed to it has a length between a minimum and maximum. Uses len(), so it can work for strings, lists, or anything with length. :param min: The minimum length. If not provided, minimum length will not be checked. :param max: The maximum length. If not provided, maximum length will not be checked. :param equal: The exact length. If provided, maximum and minimum length will not be checked. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}`, `{min}` and `{max}`. z"Shorter than minimum length {min}.z!Longer than maximum length {max}.z'Length must be between {min} and {max}.zLength must be {equal}.N)equalr r int | Nonerrr r cCs8|durt||grtd||_||_||_||_dS)NzVThe `equal` parameter was provided, maximum or minimum parameter must not be provided.)anyr_rrr r)rrrrr rrrr0s zLength.__init__rrcCsd|jd|jd|jS)Nrrz, equal=)rrrrrrrrszLength._repr_argsrrrscCs|jp|j||j|j|jdS)N)rfrrr)r rhrrrrrrrris zLength._format_errorcCst|}|jdur||jkrt|||j|S|jdur6||jkr6|jdur+|jn|j}t||||jdurS||jkrS|jdurH|j n|j}t||||Sr ) lenrrri message_equalrrrrr)rrlengthrsrrrr"s  zLength.__call__r)rrrrrrr r r$)rrrsrrr)rrrr) rr&r'r(rrrrr0rrir"rrrrr~s  rc@sBeZdZdZdZdddddZdd d ZdddZdddZdS)EqualaValidator which succeeds if the ``value`` passed to it is equal to ``comparable``. :param comparable: The object to compare to. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}` and `{other}`. zMust be equal to {other}.Nr+r r cCs||_|p|j|_dSr ) comparabler`r )rrr rrrr0szEqual.__init__rrcCr1)Nz comparable=)rrrrrrr2zEqual._repr_argsrr cC|jj||jdS)N)rfother)r rhrr!rrrrizEqual._format_errorcCs||jkr t|||Sr )rrrir!rrrr"s zEqual.__call__rr$)rr rrr rr&r'r(r`r0rrir"rrrrrs  rc@sdeZdZdZdZ ddddd d ZdddZdddZej dddZ ej d ddZ ddZ dS)!Regexpa Validator which succeeds if the ``value`` matches ``regex``. .. note:: Uses `re.match`, which searches for a match at the beginning of a string. :param regex: The regular expression string to use. Can also be a compiled regular expression pattern. :param flags: The regexp flags to use, for example re.IGNORECASE. Ignored if ``regex`` is not a string. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}` and `{regex}`. z'String does not match expected pattern.rNr+rustr | bytes | typing.Patternflagsintr r cCs0t|ttfr t||n||_|p|j|_dSr )r5rbytesrNrOrur`r )rrurr rrrr0szRegexp.__init__rrcCr1)Nzregex=)rurrrrrr2zRegexp._repr_argsr str | bytescCs|jj||jjdS)N)rfru)r rhrupatternr!rrrrirczRegexp._format_errorcCrr rr!rrrr"r#zRegexp.__call__rcCrr rr!rrrr"r#cCs"|j|durt|||Sr )rur~rrir!rrrr"s)r)rurrrr r r$)rrrrrw)rrrr) rr&r'r(r`r0rritypingoverloadr"rrrrrs    rc@sBeZdZdZdZdddd d Zdd d ZdddZdddZdS) PredicateaCall the specified ``method`` of the ``value`` object. The validator succeeds if the invoked method returns an object that evaluates to True in a Boolean context. Any additional keyword argument will be passed to the method. :param method: The name of the method to invoke. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}` and `{method}`. :param kwargs: Additional keyword arguments to pass to the method. Invalid input.Nr+methodrr r cKs||_|p|j|_||_dSr )rr`r r9)rrr r9rrrr0s  zPredicate.__init__rcCrb)Nzmethod=z , kwargs=)rr9rrrrrrczPredicate._repr_argsrrcCr)N)rfr)r rhrr!rrrri!rzPredicate._format_errorr cCs.t||j}|di|jst|||S)Nr)getattrrr9rri)rrrrrrr"$s zPredicate.__call__)rrr r r$)rrrrrrrrrrr s   rc@sBeZdZdZdZdddd d Zdd dZdddZdddZdS)NoneOfzValidator which fails if ``value`` is a member of ``iterable``. :param iterable: A sequence of invalid values. :param error: Error message to raise in case of a validation error. Can be interpolated using `{input}` and `{values}`. rNr+iterabletyping.Iterabler r cCs.||_ddd|jD|_|p|j|_dS)Nrcs|]}t|VqdSr r).0eachrrr 9z"NoneOf.__init__..)rrM values_textr`r )rrr rrrr07szNoneOf.__init__rrcCr1)Nz iterable=)rrrrrr<r2zNoneOf._repr_argscCr)N)rfvalues)r rhrr!rrrri?rzNoneOf._format_errorrrcCs4z||jvr t||W|StyY|Swr )rrri TypeErrorr!rrrr"Bs  zNoneOf.__call__)rrr r r$r%rrrrrr-s  rc@sTeZdZdZdZ ddddd d ZdddZdddZdddZe fd ddZ dS)!OneOfaPValidator which succeeds if ``value`` is a member of ``choices``. :param choices: A sequence of valid values. :param labels: Optional sequence of labels to pair with the choices. :param error: Error message to raise in case of a validation error. Can be interpolated with `{input}`, `{choices}` and `{labels}`. zMust be one of: {choices}.Nr+choicesrlabelstyping.Iterable[str] | Noner r cCsX||_ddd|jD|_|dur|ng|_ddd|jD|_|p(|j|_dS)Nrcsrr r)rchoicerrrr_rz!OneOf.__init__..csrr r)rlabelrrrrar)rrM choices_textr labels_textr`r )rrrr rrrr0Ws zOneOf.__init__rrcCrb)Nzchoices=z , labels=)rrrrrrrdrczOneOf._repr_argscCs|jj||j|jdS)N)rfrr)r rhrrr!rrrrigs zOneOf._format_errorrrc CsHz||jvr t||W|Sty#}zt|||d}~wwr )rrrir)rrr rrrr"ls zOneOf.__call__ valuegetter/str | typing.Callable[[typing.Any], typing.Any]'typing.Iterable[tuple[typing.Any, str]]cs8trntt|j|jdd}fdd|DS)aReturn a generator over the (value, label) pairs, where value is a string associated with each choice. This convenience method is useful to populate, for instance, a form select field. :param valuegetter: Can be a callable or a string. In the former case, it must be a one-argument callable which returns the value of a choice. In the latter case, the string specifies the name of an attribute of the choice objects. Defaults to `str()` or `str()`. r) fillvaluec3s |] \}}||fVqdSr r)rrrrrrrsz OneOf.options..)callablerrrr)rrpairsrrroptionsusz OneOf.optionsr )rrrrr r r$r%)rrrr) rr&r'r(r`r0rrir"rrrrrrrLs   rc0eZdZdZdZd fdd Zd d d ZZS) ContainsOnlya1Validator which succeeds if ``value`` is a sequence and each element in the sequence is also in the sequence passed as ``choices``. Empty input is considered valid. :param choices: Same as :class:`OneOf`. :param labels: Same as :class:`OneOf`. :param error: Same as :class:`OneOf`. .. versionchanged:: 3.0.0b2 Duplicate values are considered valid. .. versionchanged:: 3.0.0b2 Empty input is considered valid. Use `validate.Length(min=1) ` to validate against empty inputs. z:One or more of the choices you made was not in: {choices}.rrc ddd|D}t|S)Nrcsrr rrvalrrrrrz-ContainsOnly._format_error..rMsuperrirr value_textrrrri zContainsOnly._format_errorrtyping.Sequence[_T]cCs&|D]}||jvrt||q|Sr )rrrirrrrrrr"s  zContainsOnly.__call__r$rrrrrr&r'r(r`rir" __classcell__rrrrrs rcr) ContainsNoneOfa)Validator which fails if ``value`` is a sequence and any element in the sequence is a member of the sequence passed as ``iterable``. Empty input is considered valid. :param iterable: Same as :class:`NoneOf`. :param error: Same as :class:`NoneOf`. .. versionadded:: 3.6.0 z5One or more of the choices you made was in: {values}.rrcr)Nrcsrr rrrrrrrz/ContainsNoneOf._format_error..rrrrrrirzContainsNoneOf._format_errorrrcCs&|D]}||jvrt||q|Sr )rrrirrrrr"s  zContainsNoneOf.__call__r$rrrrrrrs  r)%r( __future__rrNrr6abcrr itertoolsroperatorrmarshmallow.exceptionsrmarshmallow.warningsr TYPE_CHECKING marshmallowr TypeVarr r r*rBrxrSizedrrrrrrrrrrrrrs8       7 <MB0"=