i1T2SrSSKrSSKrSSKJr SSKJr SSKJrJr SSK J r J r J r J r SSKJr SS KJr /S QrS rS r\S 5r\ "SSSS9"SS55rSr\ "SSSS9"SS55rS=Sjr\ "SSSS9"SS55rSr\ "SSSS9"SS55rSr\ "SSSS9"SS55rS r\ "SSSS9"S!S"55r S>S#jr!\ "SSSS9"S$S%55r"S?S&jr#\ "SSSS9"S'S(55r$S)r%S*r&S+r'S,r(\ "SSSS9"S-S.55r)S/r*\ "SSSS9"S0S155r+S2r,\ "SSSS9"S3S455r-S5r.\ "SSSS9"S6S755r/S\0\14S8.S9jr2\ "SSSS9"S:S;55r3S<r4g)@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$[U(+5 g)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 N)r)rs N/var/www/html/ai-image-ml/venv/lib/python3.13/site-packages/attr/validators.pyr r *s8|$c [5(+$)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#v# [5n[S5 Sv [U5 g![U5 f=f7f)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"rrHs0  Du! 4 4 s9) 9 69FT)reprslots unsafe_hashc.\rSrSr\"5rSrSrSrg)_InstanceOfValidator\c [X0R5(dHSURSUR<SU<SUR<S3 n[ UUURU5eg)@ 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   ,r#c$SUR<S3$)Nz r5r:s r"__repr___InstanceOfValidator.__repr__m1$))a@@r#r%N __name__ __module__ __qualname____firstlineno__r r5r?rE__static_attributes__r%r#r"r,r,\ 8D Ar#r,c[U5$)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,rCs r"rrq  %%r#)r(frozenr)c<\rSrSr\"5r\"5rSrSrSr g)_MatchesReValidatorcURU5(dDSURSURR<SU<S3n[UUURU5eg)r/r0z' must match regex z (z doesn't)N) match_funcr6pattern ValueErrorr9s r"r?_MatchesReValidator.__call__s`u%%dii[ 3DLL4H4H3K2eYV_`C   &r#c$SUR<S3$)Nz"matches_re..s!N=M(ajj3V3=Ms*,zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchformatjoinsortedsetrXr4rr8compilerS)regexflagsfunc valid_funcsr>rWrVs r"rrs*<<ryy"((;K )00 IINS=MNN   o%!! fCC. **U* rxx]]  ^^ && w 33r#c.\rSrSr\"5rSrSrSrg)_OptionalValidatorc0UcgURXU5 gN validatorr:r;r<r=s r"r?_OptionalValidator.__call__s =  t5)r#c$SUR<S3$)NzrurDs r"rE_OptionalValidator.__repr__s)$..);9EEr#r%N) rIrJrKrLr rvr?rErMr%r#r"rqrqsI* Fr#rqcv[U[[45(a[[ U55$[U5$)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. )r4listtuplerqr rus r"rrs0)dE]++!- ":;; i ((r#c:\rSrSr\"5r\"SS9rSrSrSr g) _InValidatorF)hashcX0R;nU(d:SURSUR<SU<S3n[ UUURU5eg![a SnNPf=f)NFr0z ' must be in r2))optionsr8r6_original_optionsrX)r:r;r<r= in_optionsr>s r"r?_InValidator.__call__sx ,,.Jdii[ d.D.D-GveYVWXC&&   J sA A! A!c$SUR<S3$)Nzr=N)callablerrgr6r7)r:r;r<r=messages r"r?_IsCallableValidator.__call__(sN8 #NN%#   r#cg)Nzr%rDs r"rE_IsCallableValidator.__repr__8s(r#r%N)rIrJrKrLr?rErMr%r#r"rr&s  )r#rc[5$)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. )rr%r#r"rr<s  !!r#cZ\rSrSr\"\"5S9r\"S\"\"55S9rSr Sr Sr g) _DeepIterableiLruN)defaultrvcxURbURXU5 UHnURXU5 M gr/Niterable_validatormember_validator)r:r;r<r=members r"r?_DeepIterable.__call__Ss:  " " .  # #D 6F  ! !$f 5r#chURcSOSUR<3nSUSUR<S3$)N z*?T225Q 8 r#r%) rIrJrKrLr rrrrr?rErMr%r#r"rrLs0 6 76  r#rc[U[[45(a[U6n[U[[45(a[U6n[ X5$)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. )r4r|r}r rrrs r"rrisL&"T5M22!12$tUm44!#56 ) >>r#c\rSrSr\"\"\"55S9r\"\"\"55S9r\"\"\"55S9r Sr Sr Sr g) _DeepMappingirucURbURXU5 UHEnURbURXU5 URcM1URXX45 MG gr)mapping_validator key_validatorvalue_validator)r:r;r<r=keys r"r?_DeepMapping.__call__sd  ! ! -  " "4u 5C!!-""4s3##/$$T< r#c@SUR<SUR<S3$)Nz,P>P=SSWX\XlXlWoopqqr#r%N) rIrJrKrLr rrrrrr?rErMr%r#r"rrsAXkm%<=Mx '>?O+-)@A =rr#rcUcUc Sn[U5e[U[[45(a[ U6n[U[[45(a[ U6n[U[[45(a[ U6n[ XU5$)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)rXr4r|r}r r)rrrr>s r"rrsD!8 O o-$//m, /D%=110#dE]33 "34  8I JJr#cJ\rSrSr\"5r\"5r\"5rSrSr Sr g)_NumberValidatoricURX0R5(d7SURSURSURSU3n[ U5eg)r/r0r1r: N) compare_funcboundr6 compare_oprXr9s r"r?_NumberValidator.__call__sS   33dii[ 4??*;1TZZL5'RCS/ !4r#c<SURSURS3$)Nz=)rrrrs r"rrrr#c8[US[R5$)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 rB)rrrrs r"rr rr#c.\rSrSr\"5rSrSrSrg)_MaxLengthValidatoric[U5UR:a3SURSURS[U53n[U5eg)r/ Length of 'z ' must be <= rN)len max_lengthr6rXr9s r"r?_MaxLengthValidator.__call__H u: ' {-7H3u:,WCS/ ! (r#c"SURS3$)Nz= rN)r min_lengthr6rXr9s r"r?_MinLengthValidator.__call__;rr#c"SURS3$)Nzrgrrws r"r?_NotValidator.__call__su  NN4u -"nn"nn   ~~   sA##A65A6c@SUR<SUR<S3$)Nz>*rr Exceptionrr}rr?rErMr%r#r"rrzsOI ! -  C ))4*51 I"]r#r)r>rcX[U5n[XU5$![a U4nNf=f)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 )r}r8r)rvr>rs r"rrs8:!)$   33 !L !s  ))c.\rSrSr\"5rSrSrSrg) _OrValidatoricURH nU"XU5 g SUR<SU<3n[U5e![a M=f=f)NzNone of z satisfied for value ) validatorsrrX)r:r;r<r=vr>s r"r?_OrValidator.__call__s\A $e$ !++@ Jo   s = A  A c$SUR<S3$)Nzr#rc/nUH6nUR[U[5(a UROU/5 M8 [[ U55$)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 )extendr4rrr})rvalsrs r"rrsD& D  Jq,$?$?ALLaSI d $$r#)rNrt)NNN)5__doc__rrc contextlibrr_configrr_maker r r r convertersr exceptionsr__all__r rrr,rrSrrqrrrrrrrrrrrrrrrrrrrrrrXr8rrrr%r#r"rs %;55'( .%$ $!!&E40AA1A(&"E$d+FF,F*-4`E40 F F1 F)*E40JJ1J. /FED1))2)* " E40  1 8?4E40rr1r.AE/KdE$d+CC,C" 3 4 4 3E$d+ < <, < 'E$d+ < <, < 'E40AA1A(&"E40!]!]1!]H J +B!4HE40>>1>&%r#