U i7g1]@s>dZddlmZddlZddlZddlmZmZddlm Z ddl m Z ddl m Z ddlmZed ZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGd d!d!eZGd"d#d#eZdS)$z-Validation classes for various types of data.) annotationsN)ABCabstractmethod) zip_longest) attrgetter)types)ValidationError_Tc@sDeZdZdZdZddddZddddZed d d d d ZdS) 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. NstrreturncCs8|}|r|dnd}d|jjd|d|jdS)N, <(zerror=z)>) _repr_args __class____name__error)selfargsr8/tmp/pip-unpacked-wheel-o_a6af_p/marshmallow/validate.py__repr__szValidator.__repr__cCsdS)zbA string representation of the args passed to this validator. Used by `__repr__`. rrrrrrr!szValidator._repr_args typing.Anyvaluer cCsdSNrrrrrr__call__'szValidator.__call__) r __module__ __qualname____doc__rrrrr!rrrrr s r c@sHeZdZdZdZddddddd Zd d d d ZdddddZdS)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.Nrztypes.Validator str | None) validatorsrcGst||_|p|j|_dSr)tupler(default_error_messager)rrr(rrr__init__Bs z And.__init__r r cCs d|jS)Nz validators=)r(rrrrrFszAnd._repr_argsrrc Csg}i}|jD]}z(||}t|ts8|dkr8t|jWqtk r}z>||jt|jtrr| |jn| t t |jW5d}~XYqXq|rt|f||S)NF)r( isinstancer rrupdatekwargsmessagesdictappendextendtypingcastlist)rrerrorsr.Z validatorrerrrrrr!Is   ( z And.__call__)rr"r#r$r*r+rr!rrrrr%+s r%c@seZdZdZGdddZeZdZddddhZd d d d d d d d dd dd ddZddddZ ddddZ dddddZ d S)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<eZdZddZdddddddZddddddd Zd S) zURL.RegexMemoizercCs i|_dSr) _memoizedrrrrr+jszURL.RegexMemoizer.__init__boolztyping.Pattern)relativeabsolute require_tldr cCsxddddg}|s|ddddd d |d d f}d }|rZ|rPd|d|f}qdd|f}n d||f}td|tjS)NzM(?:[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)?^)r1joinrecompile IGNORECASE)rr<r=r>Zhostname_variantsZ absolute_partZ relative_partpartsrrr_regex_generatorms6   z"URL.RegexMemoizer._regex_generatorcCs2|||f}||jkr(|||||j|<|j|Sr)r:rH)rr<r=r>keyrrrr!s   zURL.RegexMemoizer.__call__N)rr"r#r+rHr!rrrr RegexMemoizeris6rJzNot a valid URL.httphttpsftpZftpsFTN)r<r=schemesr>rr;ztypes.StrSequenceOrSet | Noner'cCs>|s|std||_||_|p$|j|_|p0|j|_||_dS)Nz>URL validation cannot set both relative and absolute to False.) ValueErrorr<r=default_messagerdefault_schemesrNr>)rr<r=rNr>rrrrr+s   z URL.__init__r r cCsd|jd|jS)Nz relative=z , absolute=)r<r=rrrrrszURL._repr_argscCs|jj|dSN)inputrformatr rrr _format_errorszURL._format_errorrcCsl||}|st|d|krB|dd}||jkrBt|||j|j|j}| |sht||S)Nz://r) rVrsplitlowerrN_regexr<r=r>search)rrmessageschemeregexrrrr!s   z URL.__call__) rr"r#r$rJrYrPrQr+rrVr!rrrrr9]s E r9c@steZdZdZedejejBZedejejBZ dZ dZ ddddd d Z d d d d dZ d d d ddZdS)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)r?zNot a valid email address.Nr&r'cCs|p|j|_dSr)rPr)rrrrrr+szEmail.__init__r rcCs|jj|dSrRrTr rrrrVszEmail._format_errorcCs||}|rd|krt||dd\}}|j|sBt|||jkr|j|sz|dd}Wnt k rYnX|j|r|St||S)N@idnaascii) rVrrsplit USER_REGEXmatchDOMAIN_WHITELIST DOMAIN_REGEXencodedecode UnicodeError)rrr[Z user_partZ domain_partrrrr!s       zEmail.__call__)rr"r#r$rDrErFUNICODErdrgrfrPr+rVr!rrrrr^s   r^c@szeZdZdZdZdZdZdZdZdZ dZ dd d d d d d d d ddZ ddddZ ddddddZ dddddZd 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_inclusiverr;r'cCs||_||_||_||_||_|jj|jr0|jn|jd|_|j j|jrN|j n|j d|_ |j j|jrl|jn|j|jr||j n|j d|_ dS)N)min_op)max_op)rorp) minmaxrrmrn message_minrU message_gte message_gt message_max message_lte message_lt message_all)rrqrrrmrnrrrrr+7s zRange.__init__r r cCs$d|jd|jd|jd|jS)Nmin=, max=z, min_inclusive=z, max_inclusive=)rqrrrmrnrrrrrRszRange._repr_argsr rr[r cCs|jp|j||j|jdS)N)rSrqrr)rrUrqrrrrr[rrrrVUszRange._format_errorrcCs|jdk rL|jr||jkrLn ||jkrL|jdkr6|jn|j}t||||jdk r|jrh||jkrn ||jkr|jdkr|jn|j}t||||Sr) rqrmrrrsryrrVrnrvr}rrrr!Xs&  zRange.__call__)NN)rr"r#r$rsrvryrtrurwrxr+rrVr!rrrrrls$rlc@sneZdZdZdZdZdZdZdddddddd d d d Zd dddZ dd d dddZ dddddZ 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)equalrz int | Noner')rqrrrrcCs8|dk rt||grtd||_||_||_||_dS)NzVThe `equal` parameter was provided, maximum or minimum parameter must not be provided.)anyrOrqrrrr)rrqrrrrrrrr+|szLength.__init__r r cCsd|jd|jd|jS)Nrzr{z, equal=)rqrrrrrrrrszLength._repr_argsz typing.Sizedr|cCs|jp|j||j|j|jdS)N)rSrqrrr)rrUrqrrrr}rrrrVs  zLength._format_errorrcCst|}|jdk r2||jkr.t|||j|S|jdk rl||jkrl|jdkrV|jn|j}t||||jdk r||jkr|jdkr|j n|j}t||||Sr) lenrrrV message_equalrqrrrsryrv)rrlengthr[rrrr!s  zLength.__call__)NN) rr"r#r$rsrvryrr+rrVr!rrrrr~hsr~c@sVeZdZdZdZddddddZdd d d Zd dd ddZd d d ddZdS)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'cCs||_|p|j|_dSr) comparablerPr)rrrrrrr+szEqual.__init__r r cCs d|jS)Nz comparable=)rrrrrrszEqual._repr_argsr rcCs|jj||jdS)N)rSother)rrUrr rrrrVszEqual._format_errorcCs||jkrt|||Sr)rrrVr rrrr!s zEqual.__call__ rr"r#r$rPr+rrVr!rrrrrs rc@seZdZdZdZddddddd d d Zd d ddZdd dddZej d d dddZ ej dddddZ 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&zstr | bytes | typing.Patternintr')r]flagsrcCs0t|ttfrt||n||_|p(|j|_dSr)r,r bytesrDrEr]rPr)rr]rrrrrr+szRegexp.__init__r r cCs d|jS)Nzregex=)r]rrrrrszRegexp._repr_argsz str | bytesrcCs|jj||jjdS)N)rSr])rrUr]patternr rrrrVszRegexp._format_errorcCsdSrrr rrrr!szRegexp.__call__rcCsdSrrr rrrr!scCs"|j|dkrt|||Sr)r]rerrVr rrrr!s)r) rr"r#r$rPr+rrVr3overloadr!rrrrrs rc@sXeZdZdZdZddddddd Zdd d d Zd ddddZd d dddZdS) 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&r r')methodrcKs||_|p|j|_||_dSr)rrPrr.)rrrr.rrrr+s zPredicate.__init__r cCsd|jd|jS)Nzmethod=z , kwargs=)rr.rrrrrszPredicate._repr_argsrrcCs|jj||jdS)N)rSr)rrUrr rrrrV szPredicate._format_errorcCs*t||j}|f|js&t|||Sr)getattrrr.rrV)rrrrrrr!s  zPredicate.__call__rrrrrrs  rc@sVeZdZdZdZddddddd Zd d d d Zd d ddZdddddZdS)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&typing.Iterabler')iterablercCs.||_ddd|jD|_|p&|j|_dS)Nrcss|]}t|VqdSrr ).0Zeachrrr #sz"NoneOf.__init__..)rrC values_textrPr)rrrrrrr+!szNoneOf.__init__r r cCs d|jS)Nz iterable=)rrrrrr&szNoneOf._repr_argscCs|jj||jdS)N)rSvalues)rrUrr rrrrV)szNoneOf._format_errorrrcCs6z||jkrt||Wntk r0YnX|Sr)rrrV TypeErrorr rrrr!,s  zNoneOf.__call__rrrrrrs rc@sneZdZdZdZdddddddd d Zd d d dZd d ddZdddddZe fdddddZ 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&rztyping.Iterable[str] | Noner')choiceslabelsrcCsX||_ddd|jD|_|dk r*|ng|_ddd|jD|_|pP|j|_dS)Nrcss|]}t|VqdSrr)rchoicerrrrIsz!OneOf.__init__..css|]}t|VqdSrr)rlabelrrrrKs)rrC choices_textr labels_textrPr)rrrrrrrr+As zOneOf.__init__r r cCsd|jd|jS)Nzchoices=z , labels=)rrrrrrrNszOneOf._repr_argscCs|jj||j|jdS)N)rSrr)rrUrrr rrrrVQs zOneOf._format_errorrrc CsTz||jkrt||Wn2tk rN}zt|||W5d}~XYnX|Sr)rrrVr)rrrrrrr!Vs  "zOneOf.__call__z/str | typing.Callable[[typing.Any], typing.Any]z'typing.Iterable[tuple[typing.Any, str]]) valuegetterr cs8tr ntt|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|]\}}||fVqdSrr)rrrrrrrpsz OneOf.options..)callablerrrr)rrpairsrrroptions_sz OneOf.options)N) rr"r#r$rPr+rrVr!r rrrrrr6s  rcs:eZdZdZdZddfdd Zdddd d ZZS) ContainsOnlyaGValidator 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 iterable choices: Same as :class:`OneOf`. :param iterable labels: Same as :class:`OneOf`. :param str 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}.r r cs ddd|D}t|S)Nrcss|]}t|VqdSrrrvalrrrrsz-ContainsOnly._format_error..rCsuperrVrrZ value_textrrrrVszContainsOnly._format_errortyping.Sequence[_T]rcCs&|D]}||jkrt||q|Sr)rrrVrrrrrrr!s zContainsOnly.__call__rr"r#r$rPrVr! __classcell__rrrrrssrcs:eZdZdZdZddfdd Zdddd d ZZS) ContainsNoneOfa6Validator 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 iterable: Same as :class:`NoneOf`. :param str error: Same as :class:`NoneOf`. .. versionadded:: 3.6.0 z5One or more of the choices you made was in: {values}.r r cs ddd|D}t|S)Nrcss|]}t|VqdSrrrrrrrsz/ContainsNoneOf._format_error..rrrrrrVszContainsNoneOf._format_errorrrcCs&|D]}||jkrt||q|Sr)rrrVrrrrr!s zContainsNoneOf.__call__rrrrrrs r)r$ __future__rrDr3abcrr itertoolsroperatorrZ marshmallowrZmarshmallow.exceptionsrTypeVarr r r%r9r^rlr~rrrrrrrrrrrs.      2<MB0"=