o iP@sdZddlZddlZddlmZddlmZmZddlm Z m Z m Z m Z ddl mZddlmZzejZWneyEeed ZYnwgd Zd d Zd dZeddZe ddddGdddZddZe ddddGdddZdPddZe ddddGdddZdd Ze ddddGd!d"d"Zd#d$Z e ddddGd%d&d&Z!d'd(Z"e ddddGd)d*d*Z#d+d,Z$e ddddGd-d.d.Z%dQd/d0Z&e ddddGd1d2d2Z'dQd3d4Z(e ddddGd5d6d6Z)d7d8Z*d9d:Z+d;d<Z,d=d>Z-e ddddGd?d@d@Z.dAdBZ/e ddddGdCdDdDZ0dEdFZ1e ddddGdGdHdHZ2dIdJZ3e ddddGdKdLdLZ4de5e6fdMdNdOZ7dS)Rz Commonly useful validators. N)contextmanager)get_run_validatorsset_run_validators) _AndValidatorand_attribattrs)default_if_none)NotCallableError)r deep_iterable deep_mappingdisabledge get_disabledgtin_ instance_of is_callablelelt matches_remax_lenmin_lennot_optionalprovides set_disabledcCst| dS)a Globally disable or enable running validators. By default, they are run. :param disabled: If ``True``, disable running all validators. :type disabled: bool .. warning:: This function is not thread-safe! .. versionadded:: 21.3.0 Nr)rr J/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/attr/validators.pyr0srcCst S)z Return a bool indicating whether validators are currently disabled or not. :return: ``True`` if validators are currently disabled. :rtype: bool .. versionadded:: 21.3.0 )rr r r r!rB rccs*tdz dVWtddStdw)z Context manager that disables running validators within its context. .. warning:: This context manager is not thread-safe! .. versionadded:: 21.3.0 FNTrr r r r!rNs  rFT)reprslotshashc@"eZdZeZddZddZdS)_InstanceOfValidatorcCs4t||jstdj|j|j|j|d||j|dS)P We use a callable class to be able to change the ``__repr__``. z?'{name}' must be {type!r} (got {value!r} that is a {actual!r}).)nametypeactualvalueN) isinstancer* TypeErrorformatr) __class__selfinstattrr,r r r!__call__ds z_InstanceOfValidator.__call__cCdj|jdS)Nz)r*r/r*r2r r r!__repr__vz_InstanceOfValidator.__repr__N__name__ __module__ __qualname__rr*r5r:r r r r!r'`s r'cCt|S)a A validator that raises a `TypeError` if the initializer is called with a wrong type for this particular attribute (checks are performed using `isinstance` therefore it's also valid to pass a tuple of types). :param type: The type to check for. :type type: type or tuple of type :raises TypeError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected type, and the value it got. )r'r7r r r!r| r)r#frozenr$c@s(eZdZeZeZddZddZdS)_MatchesReValidatorcCs0||stdj|j|jj|d||j|dS)r(z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r)patternr,N) match_func ValueErrorr/r)rDr1r r r!r5s  z_MatchesReValidator.__call__cCr6)Nz.)rD)r/rDr9r r r!r:r;z_MatchesReValidator.__repr__N)r=r>r?rrDrEr5r:r r r r!rCs  rCc Cstjdtjtjf}||vr tddtddt|Dt |t r.|r+t d|}nt ||}|tjur=|j}n |tjurF|j}n|j}t ||S)a A validator that raises `ValueError` if the initializer is called with a string that doesn't match *regex*. :param regex: a regex string or precompiled pattern to match against :param int flags: flags that will be passed to the underlying re function (default 0) :param callable func: which underlying `re` function to call. Valid options are `re.fullmatch`, `re.search`, and `re.match`; the default ``None`` means `re.fullmatch`. For performance reasons, the pattern is always precompiled using `re.compile`. .. versionadded:: 19.2.0 .. versionchanged:: 21.3.0 *regex* can be a pre-compiled pattern. Nz'func' must be one of {}.z, css|] }|r |jp dVqdS)NoneN)r=).0er r r! s zmatches_re..zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchrFr/joinsortedsetr-Patternr.compilerC)regexflagsfunc valid_funcsrDrEr r r!rs0     rc@r&)_ProvidesValidatorcCs0|j|stdj|j|j|d||j|dS)r(z<'{name}' must provide {interface!r} which {value!r} doesn't.)r) interfacer,N)rY providedByr.r/r)r1r r r!r5s  z_ProvidesValidator.__call__cCr6)Nz0rY)r/rYr9r r r!r:r;z_ProvidesValidator.__repr__N)r=r>r?rrYr5r:r r r r!rXs rXcCr@)a) A validator that raises a `TypeError` if the initializer is called with an object that does not provide the requested *interface* (checks are performed using ``interface.providedBy(value)`` (see `zope.interface `_). :param interface: The interface to check for. :type interface: ``zope.interface.Interface`` :raises TypeError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected interface, and the value it got. )rXr[r r r!rsrc@r&)_OptionalValidatorcCs|durdS||||dSN validatorr1r r r!r5sz_OptionalValidator.__call__cCsdjt|jdS)Nz')what)r/r#r_r9r r r!r: z_OptionalValidator.__repr__N)r=r>r?rr_r5r:r r r r!r\s r\cCst|tr tt|St|S)a A validator that makes an attribute optional. An optional attribute is one which can be set to ``None`` in addition to satisfying the requirements of the sub-validator. :param validator: A validator (or a list of validators) that is used for non-``None`` values. :type validator: callable or `list` of callables. .. versionadded:: 15.1.0 .. versionchanged:: 17.1.0 *validator* can be a list of validators. )r-listr\rr^r r r!rs rc@r&) _InValidatorcCsNz||jv}Wn tyd}Ynw|s%tdj|j|j|d||j|dS)NFz/'{name}' must be in {options!r} (got {value!r}))r)optionsr,)rdr.rFr/r))r2r3r4r, in_optionsr r r!r5&s  z_InValidator.__call__cCr6)Nz(rd)r/rdr9r r r!r:6r;z_InValidator.__repr__N)r=r>r?rrdr5r:r r r r!rc"s rccCr@)a A validator that raises a `ValueError` if the initializer is called with a value that does not belong in the options provided. The check is performed using ``value in options``. :param options: Allowed options. :type options: list, tuple, `enum.Enum`, ... :raises ValueError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected options, and the value it got. .. versionadded:: 17.1.0 .. versionchanged:: 22.1.0 The ValueError was incomplete until now and only contained the human readable error message. Now it contains all the information that has been promised since 17.1.0. )rcrfr r r!r<src@seZdZddZddZdS)_IsCallableValidatorcCs,t|sd}t|j|j||jd|ddS)r(z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r)r,r+)msgr,N)callabler r/r)r0)r2r3r4r,messager r r!r5Ts z_IsCallableValidator.__call__cCsdS)Nzr r9r r r!r:dsz_IsCallableValidator.__repr__N)r=r>r?r5r:r r r r!rgRs rgcCstS)ax A validator that raises a `attr.exceptions.NotCallableError` if the initializer is called with a value for this particular attribute that is not callable. .. versionadded:: 19.1.0 :raises `attr.exceptions.NotCallableError`: With a human readable error message containing the attribute (`attrs.Attribute`) name, and the value it got. )rgr r r r!rhs rc@s:eZdZeedZedeedZddZddZ dS) _DeepIterabler^Ndefaultr_cCs4|jdur |||||D] }||||qdSr(N)iterable_validatormember_validator)r2r3r4r,memberr r r!r5~s z_DeepIterable.__call__cCs*|jdurdnd|j}dj||jdS)Nr  zJ)iterable_identifierrq)ror/rp)r2rsr r r!r:s  z_DeepIterable.__repr__) r=r>r?rrrprror5r:r r r r!rkws   rkcCs t|ttfr t|}t||S)a4 A validator that performs deep validation of an iterable. :param member_validator: Validator(s) to apply to iterable members :param iterable_validator: Validator to apply to iterable itself (optional) .. versionadded:: 19.1.0 :raises TypeError: if any sub-validators fail )r-rbtuplerrkrpror r r!r s  r c@sFeZdZeedZeedZedeedZddZ ddZ dS) _DeepMappingr^NrlcCsF|jdur |||||D]}|||||||||qdSrn)mapping_validator key_validatorvalue_validator)r2r3r4r,keyr r r!r5s z_DeepMapping.__call__cCdj|j|jdS)NzA)rzr,)r/rxryr9r r r!r:s z_DeepMapping.__repr__) r=r>r?rrrxryrrwr5r:r r r r!rvs    rvcCs t|||S)a} A validator that performs deep validation of a dictionary. :param key_validator: Validator to apply to dictionary keys :param value_validator: Validator to apply to dictionary values :param mapping_validator: Validator to apply to top-level mapping attribute (optional) .. versionadded:: 19.1.0 :raises TypeError: if any sub-validators fail )rv)rxryrwr r r!rs rc@s.eZdZeZeZeZddZddZdS)_NumberValidatorcCs.|||jstdj|j|j|j|ddS)r(z&'{name}' must be {op} {bound}: {value})r)opboundr,N) compare_funcr~rFr/r) compare_opr1r r r!r5sz_NumberValidator.__call__cCr{)Nz)r}r~)r/rr~r9r r r!r:raz_NumberValidator.__repr__N) r=r>r?rr~rrr5r:r r r r!r|s  r|cCt|dtjS)z A validator that raises `ValueError` if the initializer is called with a number larger or equal to *val*. :param val: Exclusive upper bound for values .. versionadded:: 21.3.0 <)r|operatorrvalr r r!r rcCr)z A validator that raises `ValueError` if the initializer is called with a number greater than *val*. :param val: Inclusive upper bound for values .. versionadded:: 21.3.0 z<=)r|rrrr r r!rrrcCr)z A validator that raises `ValueError` if the initializer is called with a number smaller than *val*. :param val: Inclusive lower bound for values .. versionadded:: 21.3.0 z>=)r|rrrr r r!rrrcCr)z A validator that raises `ValueError` if the initializer is called with a number smaller or equal to *val*. :param val: Exclusive lower bound for values .. versionadded:: 21.3.0 >)r|rrrr r r!r rrc@r&)_MaxLengthValidatorcCs.t||jkrtdj|j|jt|ddS)r(z*Length of '{name}' must be <= {max}: {len})r)maxlenN)r max_lengthrFr/r)r1r r r!r5z_MaxLengthValidator.__call__cCd|jdS)Nzr?rrr5r:r r r r!r rcCr@)z A validator that raises `ValueError` if the initializer is called with a string or iterable that is longer than *length*. :param int length: Maximum length of the string or iterable .. versionadded:: 21.3.0 )rlengthr r r!r,r"rc@r&)_MinLengthValidatorcCs.t||jkrtdj|j|jt|ddS)r(z*Length of '{name}' must be => {min}: {len})r)minrN)r min_lengthrFr/r)r1r r r!r5<rz_MinLengthValidator.__call__cCr)Nzr?rrr5r:r r r r!r8rrcCr@)z A validator that raises `ValueError` if the initializer is called with a string or iterable that is shorter than *length*. :param int length: Minimum length of the string or iterable .. versionadded:: 22.1.0 )rrr r r!rKr"rc@r&)_SubclassOfValidatorcCs0t||jstdj|j|j|d||j|dS)r(z8'{name}' must be a subclass of {type!r} (got {value!r}).)r)r*r,N) issubclassr*r.r/r)r1r r r!r5[s z_SubclassOfValidator.__call__cCr6)Nz)r7r8r9r r r!r:lr;z_SubclassOfValidator.__repr__Nr<r r r r!rWs rcCr@)a A validator that raises a `TypeError` if the initializer is called with a wrong type for this particular attribute (checks are performed using `issubclass` therefore it's also valid to pass a tuple of types). :param type: The type to check for. :type type: type or tuple of types :raises TypeError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected type, and the value it got. )rr7r r r! _subclass_ofrrArc@sJeZdZeZeeddZeeee e e ddZ ddZ ddZd S) _NotValidatorzCnot_ validator child '{validator!r}' did not raise a captured error) converterrur^cCsNz ||||Wn |jyYdSwt|jj|j|jd||j||j)N)r_ exc_types)r_rrFrhr/r1r r r!r5sz_NotValidator.__call__cCr{)Nz;)r`r)r/r_rr9r r r!r:s z_NotValidator.__repr__N)r=r>r?rr_r rhr r Exceptionrrtrr5r:r r r r!rs r)rhrcCs2zt|}Wn ty|f}Ynwt|||S)a  A validator that wraps and logically 'inverts' the validator passed to it. It will raise a `ValueError` if the provided validator *doesn't* raise a `ValueError` or `TypeError` (by default), and will suppress the exception if the provided validator *does*. Intended to be used with existing validators to compose logic without needing to create inverted variants, for example, ``not_(in_(...))``. :param validator: A validator to be logically inverted. :param msg: Message to raise if validator fails. Formatted with keys ``exc_types`` and ``validator``. :type msg: str :param exc_types: Exception type(s) to capture. Other types raised by child validators will not be intercepted and pass through. :raises ValueError: With a human readable error message, the attribute (of type `attrs.Attribute`), the validator that failed to raise an exception, the value it got, and the expected exception types. .. versionadded:: 22.2.0 )rtr.r)r_rhrr r r!rs     r)rNr])8__doc__rrK contextlibr_configrr_makerrrr convertersr exceptionsr rRAttributeErrorr*rS__all__rrrr'rrCrrXrr\rrcrrgrrkr rvrr|rrrrrrrrrrrrFr.rr r r r!sx          0              )