gNNhdZddlZddlZddlmZddlmZddlmZmZddl m Z m Z m Z m Z ddlmZdd lmZgd Zd Zd Zed Ze dddGddZdZe dddGddZd=dZe dddGddZdZe dddGddZdZe dddGddZd Ze dddGd!d"Z d>d#Z!e dddGd$d%Z"d>d&Z#e dddGd'd(Z$d)Z%d*Z&d+Z'd,Z(e dddGd-d.Z)d/Z*e dddGd0d1Z+d2Z,e dddGd3d4Z-d5Z.e dddGd6d7Z/de0e1fd8d9Z2e dddGd:d;Z3d<Z4dS)?z Commonly useful validators. N)contextmanager)Pattern)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_optionalor_ set_disabledc&t| dS)a Globally disable or enable running validators. By default, they are run. Args: disabled (bool): If `True`, disable running all validators. .. warning:: This function is not thread-safe! .. versionadded:: 21.3.0 Nr)rs [/var/www/html/nodeJS/PythonScripts/venv3.11/lib/python3.11/site-packages/attr/validators.pyrr*s8|$$$$$c t S)z Return a bool indicating whether validators are currently disabled or not. Returns: bool:`True` if validators are currently disabled. .. versionadded:: 21.3.0 )rr#r"rr<s"## ##r#c#xKtd dVtddS#tdwxYw)z Context manager that disables running validators within its context. .. warning:: This context manager is not thread-safe! .. versionadded:: 21.3.0 FNTr!r%r#r"rrHsMu! 4     4    s(9FT)reprslots unsafe_hashc.eZdZeZdZdZdS)_InstanceOfValidatorc t||js5d|jd|jd|d|jd }t |||j|dS)P We use a callable class to be able to change the ``__repr__``. ' ' must be  (got z that is a ).N) isinstancetypename __class__ TypeErrorselfinstattrvaluemsgs r"__call__z_InstanceOfValidator.__call__^sr%++ gdigg49ggeggRWRagggC     r#cd|jdS)Nz r3r8s r"__repr__z_InstanceOfValidator.__repr__k@$)@@@@r#N__name__ __module__ __qualname__r r3r=rBr%r#r"r+r+ZB 688D   AAAAAr#r+c t|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). Args: type (type | tuple[type]): The type to check for. Raises: TypeError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected type, and the value it got. )r+r@s r"rro  % %%r#)r'frozenr(cBeZdZeZeZdZdZdS)_MatchesReValidatorc||s2d|jd|jjd|d}t|||j|dS)r-r.z' must match regex z (z doesn't)N) match_funcr4pattern ValueErrorr7s r"r=z_MatchesReValidator.__call__siu%% `di``DL4H``e```C     r#cd|jdS)Nz"zmatches_re..s.NN(aj3VNNNNNNr#zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchformatjoinsortedsetrQr2rr6compilerM)regexflagsfunc valid_funcsr<rPrOs r"rrs*<ry"(;K ;)00 IINNS=M=MNNNNN     oo%!!+  !fCC.. *UE** rx]   ^ & w 3 33r#c.eZdZeZdZdZdS)_OptionalValidatorc<|dS||||dSN validatorr8r9r:r;s r"r=z_OptionalValidator.__call__s( = F tT5)))))r#cd|jdS)NzrjrAs r"rBz_OptionalValidator.__repr__sE$.EEEEr#N)rErFrGr rkr=rBr%r#r"rgrgsBI*** FFFFFr#rgct|ttfrtt |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. Args: validator (typing.Callable | tuple[typing.Callable] | list[typing.Callable]): A validator (or validators) that is used for non-`None` values. .. versionadded:: 15.1.0 .. versionchanged:: 17.1.0 *validator* can be a list of validators. .. versionchanged:: 23.1.0 *validator* can also be a tuple of validators. )r2listtuplergrrjs r"rrs>)dE]++<!- ":":;;; i ( ((r#cFeZdZeZedZdZdZdS) _InValidatorF)hashc ||jv}n#t$rd}YnwxYw|s-d|jd|jd|d}t |||j|dS)NFr.z ' must be in r0))optionsr6r4_original_optionsrQ)r8r9r:r; in_optionsr<s r"r=z_InValidator.__call__s $,.JJ   JJJ  XdiXXd.DXXeXXXC&    s cd|jdS)Nzr%rAs r"rBz_IsCallableValidator.__repr__6s((r#N)rErFrGr=rBr%r#r"r~r~$s2 )))))r#r~ctS)a A validator that raises a `attrs.exceptions.NotCallableError` if the initializer is called with a value for this particular attribute that is not callable. .. versionadded:: 19.1.0 Raises: attrs.exceptions.NotCallableError: With a human readable error message containing the attribute (`attrs.Attribute`) name, and the value it got. )r~r%r#r"rr:s ! !!r#c~eZdZeeZedeeZdZdZ dS) _DeepIterablerjNdefaultrkcz|j|||||D]}||||dSr-Niterable_validatormember_validator)r8r9r:r;members r"r=z_DeepIterable.__call__QsY  " .  # #D$ 6 6 6 6 6F  ! !$f 5 5 5 5 6 6r#cD|jdn d|j}d|d|jdS)N z 8 8!2 8 8 8 r#) rErFrGr rrrrr=rBr%r#r"rrJswv 666 7 7666      r#rclt|ttfr t|}t ||S)aC A validator that performs deep validation of an iterable. Args: member_validator: Validator to apply to iterable members. iterable_validator: Validator to apply to iterable itself (optional). Raises TypeError: if any sub-validators fail .. versionadded:: 19.1.0 )r2rorpr rrrs r"rrgs9"T5M223!12 )+= > >>r#ceZdZeeZeeZedeeZdZ dZ dS) _DeepMappingrjNrc|j|||||D]6}|||||||||7dSr)mapping_validator key_validatorvalue_validator)r8r9r:r;keys r"r=z_DeepMapping.__call__su  ! -  " "4u 5 5 5 9 9C   tT3 / / /  tU3Z 8 8 8 8 9 9r#c(d|jd|jdS)Nz,PqqX\Xlqqqqr#) rErFrGr rrrrrr=rBr%r#r"rr{sF[[]]333Mf{{}}555Otxx 7N7NOOO 9 9 9rrrrrr#rc$t|||S)a A validator that performs deep validation of a dictionary. Args: key_validator: Validator to apply to dictionary keys. value_validator: Validator to apply to dictionary values. mapping_validator: Validator to apply to top-level mapping attribute (optional). .. versionadded:: 19.1.0 Raises: TypeError: if any sub-validators fail )r)rrrs r"rrs"  8I J JJr#cVeZdZeZeZeZdZdZdS)_NumberValidatorc|||js,d|jd|jd|jd|}t |dS)r-r.r/r: N) compare_funcboundr4 compare_oprQr7s r"r=z_NumberValidator.__call__s_   33 "RdiRR4?RRTZRR5RRCS// ! " "r#c(d|jd|jdS)Nz=)rrrrs r"rrrr#c8t|dtjS)a  A validator that raises `ValueError` if the initializer is called with a number smaller or equal to *val*. The validator uses `operator.ge` to compare the values. Args: val: Exclusive lower bound for values .. versionadded:: 21.3.0 r?)rrrrs r"rrrr#c.eZdZeZdZdZdS)_MaxLengthValidatorct||jkr1d|jd|jdt|}t|dS)r- Length of 'z ' must be <= rN)len max_lengthr4rQr7s r"r=z_MaxLengthValidator.__call__R u:: ' 'W WWWW3u::WWCS// ! ( 'r#cd|jdS)Nz= rN)r min_lengthr4rQr7s r"r=z_MinLengthValidator.__call__rr#cd|jdS)Nz\\\\\\r#N)rErFrGr rkr r<rr Exceptionrrprr=rBr%r#r"rrRsI &!/ -     C -)\)44*{511   I"]]]]]r#r)r<rcl t|}n#t$r|f}YnwxYwt|||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_(...))``. Args: validator: A validator to be logically inverted. msg (str): Message to raise if validator fails. Formatted with keys ``exc_types`` and ``validator``. exc_types (tuple[type, ...]): 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 )rpr6r)rkr<rs r"rrwsN:!)$$ !!!L ! C 3 33s  ""c.eZdZeZdZdZdS) _OrValidatorc|jD]"} ||||dS#t$rYwxYwd|jd|}t|)NzNone of z satisfied for value ) validatorsrrQ)r8r9r:r;vr<s r"r=z_OrValidator.__call__s}  A $e$$$     KJJJJoos  ((cd|jdS)Nz>>>>r#rcg}|D]4}|t|tr|jn|g5tt |S)a A validator that composes multiple validators into one. When called on a value, it runs all wrapped validators until one of them is satisfied. Args: validators (~collections.abc.Iterable[typing.Callable]): Arbitrary number of validators. Raises: ValueError: If no validator is satisfied. Raised with a human-readable error message listing all the wrapped validators and the value that failed all of them. .. versionadded:: 24.1.0 )extendr2rrrp)rvalsrs r"rrsZ& D JJ Jq,$?$?HALLaSIIII d $ $$r#)rNri)5__doc__rrY contextlibrr_configrr_makerr r r convertersr exceptionsr __all__rrrr+rrMrrgrrrrr~rrrrrrrrrrrrrrrrrrQr6rrrr%r#r"rs %%%%%%;;;;;;;;555555555555''''''((((((   .%%%$ $ $ $!!!"E4000AAAAAAA10A(&&&"E$d+++FFFFFFF,+F*-4-4-4-4`E4000 F F F F F F F10 F)))*E4000JJJJJJJ10J. / / /FED111)))))))21)* " " " E4000       10 8????(E4000rrrrrrr10r(KKKK(E$d+++CCCCCCC,+C" 3 3 3 4 4 4 4 4 4 3 3 3E$d+++ < < < < < < <,+ < ' ' 'E$d+++ < < < < < < <,+ < ' ' 'E4000AAAAAAA10A(&&&"E4000!]!]!]!]!]!]!]10!]H J +B!4!4!4!4!4HE4000>>>>>>>10>&%%%%%r#