+ TŎiSRt^RIt^RIt^RIHt^RIHt^RIHtHt^RI H t H t H t H t ^RIHt^RIHt.R;OtRtR t]R 4t] !R R R R 7!RR44tRt] !R R R R7!RR44tRR#lt#] !R R R R7!R$R%44t$R&t%R't&R(t'R)t(] !R R R R7!R*R+44t)R,t*] !R R R R7!R-R.44t+R/t,] !R R R R 7!R0R144t-R2t.] !R R R R 7!R3R444t/R5RR6]0]13/R7lt2] !R R R R 7!R8R944t3R:t4R#)?z Commonly useful validators. N)contextmanager)Pattern)get_run_validatorsset_run_validators) _AndValidatorand_attribattrs)default_if_none)NotCallableErrorc&\V'*4R#)z 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)disableds&^/Users/ahmad/.openclaw/workspace/scripts/.venv/lib/python3.14/site-packages/attr/validators.py set_disabledr*s8|$c \4'*#)z Return a bool indicating whether validators are currently disabled or not. Returns: bool:`True` if validators are currently disabled. .. versionadded:: 21.3.0 )rrr get_disabledr<s"# ##rc#d"\R4Rx\R4R# \R4i;i5i)z Context manager that disables running validators within its context. .. warning:: This context manager is not thread-safe! .. versionadded:: 21.3.0 FNTr rrrrrHs(u! 4 4 s 0 0 -0FT)reprslots unsafe_hashc:a]tRt^Zto]!4tRtRtRtVt R#)_InstanceOfValidatorc  \W0P4'gIRVP RVP: RV: RVP: R2 p\ VVVPV4hR#)@ 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___InstanceOfValidator.__call__^sf%++dii[ 499-veYkRWRaRaQddfgC   ,rc$RVP: R2#)z r"r's&r__repr___InstanceOfValidator.__repr__k1$))a@@rrN __name__ __module__ __qualname____firstlineno__rr"r,r2__static_attributes____classdictcell__ __classdict__s@rrrZ 8D AArrc\V4#)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. )rr0s&r instance_ofr@o  %%r)rfrozenrcHa]tRt^to]!4t]!4tRtRtRt Vt R#)_MatchesReValidatorc VPV4'gERVP RVPP: RV: R2p\VVVPV4hR#)rrz' must match regex z (z doesn't)N) match_funcr#pattern ValueErrorr&s&&&& rr,_MatchesReValidator.__call__s`u%%dii[ 3DLL4H4H3K2eYV_`C   &rc$RVP: R2#)z"matches_re..s'N=M((ajj33V3=Ms .. .zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchformatjoinsortedsetrHr!rr%compilerD)regexflagsfunc valid_funcsr+rGrFs&&& r matches_rer`s*<<ryy"((;K )00 IINS=MNN   o%!! fCC. **U* rxx]]  ^^ && w 33rc:a]tRt^to]!4tRtRtRtVt R#)_OptionalValidatorc6VfR#VPWV4R#N validatorr'r(r)r*s&&&&rr,_OptionalValidator.__call__s =  t5)rc$RVP: R2#)zrer1s&rr2_OptionalValidator.__repr__s)$..);9EErrN) r6r7r8r9rrfr,r2r:r;r<s@rrbrbsI* FFrrbcx\V\\34'd\\ V44#\V4#)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. )r!listtuplerbrres&roptionalrns0)dE]++!- ":;; i ((rcLa]tRt^to]!4t]!RR7tRtRtRt Vt R#) _InValidatorF)hashcW0P9pV'g;RVP RVP: RV: R2p\ VVVPV4hR# \dRpLSi;i)Frz ' must be in r)N)optionsr%r#_original_optionsrH)r'r(r)r* in_optionsr+s&&&& rr,_InValidator.__call__sx ,,.Jdii[ d.D.D-GveYVWXC&&   J sA A$#A$c$RVP: R2#)zrr1s&rr2_IsCallableValidator.__repr__6s(rrN)r6r7r8r9r,r2r:r;r<s@rrr$s ))rrc\4#)ad 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. )rrrr is_callabler:s  !!rcra]tRtRto]!]!4R7t]!R]!]!44R7tRt Rt Rt Vt R#) _DeepIterableiJreN)defaultrfc |VPeVPWV4VFpVPWV4K R#rNiterable_validatormember_validator)r'r(r)r*members&&&& rr,_DeepIterable.__call__Qs:  " " .  # #D 6F  ! !$f 5rcjVPfRMRVP: 2pRV RVP: R2#)N z*?T225Q 8 rr) r6r7r8r9rrrrnrr,r2r:r;r<s@rrrJs8 6 76   rrc\V\\34'd \V!p\V\\34'd \V!p\ W4#)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. )r!rlrmrrrrs&&r deep_iterablergsL&"T5M22!12$tUm44!#56 ) >>rca]tRtRto]!]!]!44R7t]!]!]!44R7t]!]!]!44R7t Rt Rt Rt Vt R#) _DeepMappingirec VPeVPWV4VFKpVPeVPWV4VPfK3VPWW4,4KM R#r)mapping_validator key_validatorvalue_validator)r'r(r)r*keys&&&& rr,_DeepMapping.__call__sd  ! ! -  " "4u 5C!!-""4s3##/$$T< rc@RVP: RVP: R2#)z,P>P=SSWX\XlXlWoopqqrrN)r6r7r8r9rrnrrrrr,r2r:r;r<s@rrrsJXkm%<=Mx '>?O+-)@A =rrrrc"VfVfRp\V4h\V\\34'd \ V!p\V\\34'd \ V!p\V\\34'd \ V!p\ WV4#)aZ 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. zAAt least one of key_validator or value_validator must be provided)rHr!rlrmrr)rrrr+s&&& r deep_mappingrsD!8 O o-$//m, /D%=110#dE]33 "34  8I JJrcVa]tRtRto]!4t]!4t]!4tRtRt Rt Vt R#)_NumberValidatoric VPW0P4'g8RVP RVP RVP RV 2p\ V4hR#)rrrr: N) compare_funcboundr# compare_oprHr&s&&&& rr,_NumberValidator.__call__sS   33dii[ 4??*;1TZZL5'RCS/ !4rc<RVP RVP R2#)z=)rrgers&rrrrrc8\VR\P4#)z 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/)rrgtrs&rrr rrc:a]tRtRto]!4tRtRtRtVt R#)_MaxLengthValidatoric \V4VP8d4RVP RVP R\V4 2p\V4hR#)r Length of 'z ' must be <= rN)len max_lengthr#rHr&s&&&& rr,_MaxLengthValidator.__call__H u: ' {-7H3u:,WCS/ ! (rc"RVP R2#)z= rN)r min_lengthr#rHr&s&&&& rr,_MinLengthValidator.__call__9rrc"RVP R2#)zrrc\V4#)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). Args: type (type | tuple[type, ...]): The type(s) 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. )rr0s&r _subclass_ofrgrArca]tRtRto]!4t]!]!R4R7t]!]!] !] 4] !] 4R7R7t RtRtRtVtR #) _NotValidatorixzCnot_ validator child '{validator!r}' did not raise a captured error) converterrrecVPWV4\VPPVPVPR7VVPVVP4h TPdR#i;i)rf exc_typesN)rfrHr+rWrrgs&&&&rr,_NotValidator.__call__su  NN4u -"nn"nn   ~~   sA&&A;:A;c@RVP: RVP: R2#)z>* A  A c$RVP: R2#)z>rrc.pVF7pTP\V\4'd VPMV.4K9 \\ V44#)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 )extendr!rrrm)rvalsrs* ror_rsD& D  Jq,$?$?ALLaSI d $$r)rrrrrrrr}r@rrrr`rrrrnrr)Nrd)NNN)5__doc__rrS contextlibrr_configrr_makerrrr convertersr exceptionsr __all__rrrrr@rDr`rbrnrpr}rrrrrrrrrrrrrrrrrrrHr%rrrrrrrs %;55'( .%$ $!!"E40AA1A(&"E$d+FF,F*-4`E40 F F1 F)*E40JJ1J. /FED1))2)* " E40  1 8?4E40rr1r,/KdE$d+CC,C" 3 4 4 3E$d+ < <, < 'E$d+ < <, < 'E40AA1A(&"E40!]!]1!]H!44!4J +B!4HE40>>1>&%r