i1TjdZddlZddlZddlmZddlmZddlmZmZddl 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)Patternget_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 N)r)rs W/root/.openclaw/workspace/.venvs/songid/lib/python3.11/site-packages/attr/validators.pyr r *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#Kt}td dVt|dS#t|wxYw)z Context manager that disables running validators within its context. .. warning:: This context manager is not thread-safe! .. versionadded:: 21.3.0 .. versionchanged:: 26.1.0 The contextmanager is nestable. FNr)prevs r"rrHsX   Du! 4     4    s 6AFT)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 r4r9s r"__repr__z_InstanceOfValidator.__repr__m@$)@@@@r#N__name__ __module__ __qualname__r r4r>rCr%r#r"r,r,\B 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,rAs r"rrq  % %%r#)r(frozenr)cBeZdZeZeZdZdZdS)_MatchesReValidatorc||s2d|jd|jjd|d}t|||j|dS)r.r/z' must match regex z (z doesn't)N) match_funcr5pattern ValueErrorr8s r"r>z_MatchesReValidator.__call__siu%% `di``DL4H``e```C     r#cd|jdS)Nz"rCr%r#r"rNrNsMfhhGJ   FFFFFr#rNc tjdtjtjf}||vr[ddt dt|D}t|t|tr|rd}t||}ntj ||}|tjur|j}n|tjur|j}n|j}t||S)a A validator that raises `ValueError` if the initializer is called with a string that doesn't match *regex*. Args: regex (str, re.Pattern): A regex string or precompiled pattern to match against flags (int): Flags that will be passed to the underlying re function (default 0) func (typing.Callable): 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, c3,K|]}|r|jpdVdS)NoneN)rF).0es r" zmatches_re..s.NN(aj3VNNNNNNr#zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchformatjoinsortedsetrRr3rr7compilerN)regexflagsfunc valid_funcsr=rQrPs r"rrs*<ry"(;K ;)00 IINNS=M=MNNNNN     oo%!!+  !fCC.. *UE** rx]   ^ & w 3 33r#c.eZdZeZdZdZdS)_OptionalValidatorc<|dS||||dSN validatorr9r:r;r<s r"r>z_OptionalValidator.__call__s( = F tT5)))))r#cd|jdS)NzrkrBs r"rCz_OptionalValidator.__repr__sE$.EEEEr#N)rFrGrHr rlr>rCr%r#r"rhrhsBI*** FFFFFr#rhct|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. )r3listtuplerhr rks 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 r1))optionsr7r5_original_optionsrR)r9r:r;r< in_optionsr=s r"r>z_InValidator.__call__s $,.JJ   JJJ  XdiXXd.DXXeXXXC&    s cd|jdS)NzrCr%r#r"rsrssUfhhGE***   JJJJJr#rsc|}t|tttfrt |}t ||S)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``, so *options* has to support that operation. To keep the validator hashable, dicts, lists, and sets are transparently transformed into a `tuple`. Args: options: Allowed options. 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. .. versionchanged:: 24.1.0 *options* that are a list, dict, or a set are now transformed into a tuple to keep the validator hashable. )r3rpdictrarqrs)rw repr_optionss r"rrs=8L'D$,--!..  . ..r#ceZdZdZdZdS)_IsCallableValidatorct|s3d}t||j||j|dS)r.z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r5r<actual)r=r<N)callablerr^r5r6)r9r:r;r<messages r"r>z_IsCallableValidator.__call__(se 8 #NN%#    r#cdS)Nzr%rBs r"rCz_IsCallableValidator.__repr__8s((r#N)rFrGrHr>rCr%r#r"rr&s2 )))))r#rctS)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. )rr%r#r"rr<s ! !!r#c~eZdZeeZedeeZdZdZ dS) _DeepIterablerkN)defaultrlcz|j|||||D]}||||dSr.Niterable_validatormember_validator)r9r:r;r<members r"r>z_DeepIterable.__call__SsY  " .  # #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#) rFrGrHr rrrrr>rCr%r#r"rrLswv 666 7 7666      r#rct|ttfr t|}t|ttfr t|}t ||S)a A validator that performs deep validation of an iterable. Args: member_validator: Validator(s) to apply to iterable members. iterable_validator: Validator(s) to apply to iterable itself (optional). Raises TypeError: if any sub-validators fail .. versionadded:: 19.1.0 .. versionchanged:: 25.4.0 *member_validator* and *iterable_validator* can now be a list or tuple of validators. )r3rprqr rrrs r"rris\&"T5M223!12$tUm447!#56 )+= > >>r#ceZdZeeeZeeeZeeeZdZ dZ dS) _DeepMappingrkc|j|||||D]D}|j|||||j|||||EdSr)mapping_validator key_validatorvalue_validator)r9r:r;r<keys r"r>z_DeepMapping.__call__s  ! -  " "4u 5 5 5 = =C!-""4s333#/$$T4s<<<  = =r#c(d|jd|jdS)Nz,PqqX\Xlqqqqr#N) rFrGrHr rrrrrr>rCr%r#r"rrsFXXkkmm%<%<===Mfxx '>'>???O++--)@)@AAA = = =rrrrrr#rc,||d}t|t|ttfr t |}t|ttfr t |}t|ttfr t |}t |||S)a A validator that performs deep validation of a dictionary. All validators are optional, but at least one of *key_validator* or *value_validator* must be provided. Args: key_validator: Validator(s) to apply to dictionary keys. value_validator: Validator(s) to apply to dictionary values. mapping_validator: Validator(s) to apply to top-level mapping attribute. .. versionadded:: 19.1.0 .. versionchanged:: 25.4.0 *key_validator* and *value_validator* are now optional, but at least one of them must be provided. .. versionchanged:: 25.4.0 *key_validator*, *value_validator*, and *mapping_validator* can now be a list or tuple of validators. Raises: TypeError: If any sub-validator fails on validation. ValueError: If neither *key_validator* nor *value_validator* is provided on instantiation. NzAAt least one of key_validator or value_validator must be provided)rRr3rprqr r)rrrr=s r"rrsD!8 O oo-$//-m, /D%=1110#dE]335 "34  8I J JJr#cVeZdZeZeZeZdZdZdS)_NumberValidatorc|||js,d|jd|jd|jd|}t |dS)r.r/r0r: N) compare_funcboundr5 compare_oprRr8s r"r>z_NumberValidator.__call__s_   33 "RdiRR4?RRTZRR5RRCS// ! " "r#c(d|jd|jdS)NzrCr%r#r"rrsX FHHEJ688L"""CCCCCr#rc8t|dtjS)a  A validator that raises `ValueError` if the initializer is called with a number larger or equal to *val*. The validator uses `operator.lt` to compare the values. Args: val: Exclusive upper bound for values. .. versionadded:: 21.3.0 <)roperatorrvals r"rr Chk 2 22r#c8t|dtjS)a A validator that raises `ValueError` if the initializer is called with a number greater than *val*. The validator uses `operator.le` to compare the values. Args: val: Inclusive upper bound for values. .. versionadded:: 21.3.0 z<=)rrrrs r"rr Cx{ 3 33r#c8t|dtjS)a A validator that raises `ValueError` if the initializer is called with a number smaller than *val*. The validator uses `operator.ge` to compare the values. Args: val: Inclusive lower bound for values .. versionadded:: 21.3.0 z>=)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.gt` to compare the values. Args: val: Exclusive lower bound for values .. versionadded:: 21.3.0 r@)rrrrs r"rr rr#c.eZdZeZdZdZdS)_MaxLengthValidatorct||jkr1d|jd|jdt|}t|dS)r. Length of 'z ' must be <= rN)len max_lengthr5rRr8s r"r>z_MaxLengthValidator.__call__R u:: ' 'W WWWW3u::WWCS// ! ( 'r#cd|jdS)NzrCr%r#r"rr=J"""<<<<= rN)r min_lengthr5rRr8s r"r>z_MinLengthValidator.__call__;rr#cd|jdS)NzrCr%r#r"rr7rr#rc t|S)z A validator that raises `ValueError` if the initializer is called with a string or iterable that is shorter than *length*. Args: length (int): Minimum length of the string or iterable .. versionadded:: 22.1.0 )rrs r"rrGrr#c.eZdZeZdZdZdS)_SubclassOfValidatorct||js-d|jd|jd|d}t|||j|dS)r.r/z' must be a subclass of r1r2N) issubclassr4r5r7r8s r"r>z_SubclassOfValidator.__call__Xsf%++ WdiWWWWEWWWC     r#cd|jdS)Nz z_NotValidator.__call__s  NN4u - - -"n"n    ~    DD sA A('A(c(d|jd|jdS)Nz\\\\\\r#N)rFrGrHr rlr r=rr Exceptionrrqrr>rCr%r#r"rrzsI &!/ -     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 )rqr7r)rlr=rs r"rrsN:!)$$ !!!L ! C 3 33s  ""c.eZdZeZdZdZdS) _OrValidatorc|jD]"} ||||dS#t$rYwxYwd|jd|}t|)NzNone of z satisfied for value ) validatorsrrR)r9r:r;r<vr=s r"r>z_OrValidator.__call__s}  A $e$$$     KJJJJoos  ((cd|jdS)NzrCr%r#r"rrs=J   >>>>>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 )extendr3rrrq)rvalsrs r"rrsZ& D JJ Jq,$?$?HALLaSIIII d $ $$r#)rNrj)NNN)5__doc__rrZ contextlibrr_configrr_maker r r r convertersr exceptionsr__all__r rrr,rrNrrhrrsrrrrrrrrrrrrrrrrrrrrRr7rrrr%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????4E4000rrrrrrr10r.AE/K/K/K/KdE$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#