gNN0SrSSKrSSKrSSKJr 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)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$[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 Nr)rs 1/usr/lib/python3/dist-packages/attr/validators.pyrr*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#b# [S5 Sv [S5 g![S5 f=f7f)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"rrHs(u! 4 4 s / / ,/FT)reprslots unsafe_hashc.\rSrSr\"5rSrSrSrg)_InstanceOfValidatorZc [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 r4r9s r"__repr___InstanceOfValidator.__repr__k1$))a@@r#r%N __name__ __module__ __qualname____firstlineno__r r4r>rD__static_attributes__r%r#r"r+r+Z 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+rBs r"rro  %%r#)r'frozenr(c<\rSrSr\"5r\"5rSrSrSr g)_MatchesReValidatorcURU5(dDSURSURR<SU<S3n[UUURU5eg)r.r/z' must match regex z (z doesn't)N) match_funcr5pattern ValueErrorr8s r"r>_MatchesReValidator.__call__s`u%%dii[ 3DLL4H4H3K2eYV_`C   &r#c$SUR<S3$)Nz"rDrLr%r#r"rRrRshGJ Fr#rRc &[RS[R[R4nX#;aDSR SR [ S[U55555n[U5e[U[5(aU(a Sn[U5eUnO[R"X5nU[RLa URnO,U[RLa URnO URn[XV5$)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\# UH"o=(a UR=(d Sv M$ g7f)NoneN)rH).0es r" matches_re..s!N=M(ajj3V3=Ms*,zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchformatjoinsortedsetrWr3rr7compilerR)regexflagsfunc valid_funcsr=rVrUs r"rrs*<<ryy"((;K )00 IINS=MNN   o%!! fCC. **U* rxx]]  ^^ && w 33r#c.\rSrSr\"5rSrSrSrg)_OptionalValidatorc0UcgURXU5 gN validatorr9r:r;r<s r"r>_OptionalValidator.__call__s =  t5)r#c$SUR<S3$)NzrtrCs r"rD_OptionalValidator.__repr__s)$..);9EEr#r%N) rHrIrJrKr rur>rDrLr%r#r"rprpsI* Fr#rpcv[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. )r3listtuplerprrts r"rrs0)dE]++!- ":;; i ((r#c:\rSrSr\"5r\"SS9rSrSrSr g) _InValidatorF)hashcX0R;nU(d:SURSUR<SU<S3n[ UUURU5eg![a SnNPf=f)NFr/z ' must be in r1))optionsr7r5_original_optionsrW)r9r:r;r< in_optionsr=s r"r>_InValidator.__call__sx ,,.Jdii[ d.D.D-GveYVWXC&&   J sA A! A!c$SUR<S3$)NzrDrLr%r#r"r~r~shGE* Jr#r~crUn[U[[[45(a [ U5n[ X5$)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. )r3r{dictrir|r~)r repr_optionss r"rrs18L'D$,--.  ..r#c \rSrSrSrSrSrg)_IsCallableValidatori$c[U5(d.Sn[URURX3RS9US9eg)r.z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r5r<actual)r=r<N)callabler rfr5r6)r9r:r;r<messages r"r>_IsCallableValidator.__call__&sN8 #NN%#   r#cg)Nzr%rCs r"rD_IsCallableValidator.__repr__6s(r#r%N)rHrIrJrKr>rDrLr%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) _DeepIterableiJrtNdefaultrucxURbURXU5 UHnURXU5 M gr.Niterable_validatormember_validator)r9r:r;r<members r"r>_DeepIterable.__call__Qs:  " " .  # #D 6F  ! !$f 5r#chURcSOSUR<3nSUSUR<S3$)N z*?T225Q 8 r#r%) rHrIrJrKr rrrrr>rDrLr%r#r"rrJs0 6 76  r#rc^[U[[45(a[U6n[ X5$)a 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 )r3r{r|r rrrs r"rrgs."T5M22!12 ) >>r#cp\rSrSr\"\"5S9r\"\"5S9r\"S\"\"55S9r Sr Sr Sr g) _DeepMappingi{rtNrcURbURXU5 UH)nURXU5 URXX45 M+ gr)mapping_validator key_validatorvalue_validator)r9r:r;r<keys r"r>_DeepMapping.__call__sL  ! ! -  " "4u 5C   t3 /  UZ 8r#c@SUR<SUR<S3$)Nz,P>P=SSWX\XlXlWoopqqr#r%) rHrIrJrKr rrrrrr>rDrLr%r#r"rr{s9[]3M{}5Otx 7NO 9rr#rc[XU5$)ag 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 JJr#cJ\rSrSr\"5r\"5r\"5rSrSr Sr g)_NumberValidatoricURX0R5(d7SURSURSURSU3n[ U5eg)r.r/r0r: N) compare_funcboundr5 compare_oprWr8s r"r>_NumberValidator.__call__sS   33dii[ 4??*;1TZZL5'RCS/ !4r#c<SURSURS3$)NzrDrLr%r#r"rrs" HEJ8L"Cr#rc8[US[R5$)z 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 Chkk 22r#c8[US[R5$)z 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{{ 33r#c8[US[R5$)z 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#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.ge` to compare the values. Args: val: Exclusive lower bound for values .. versionadded:: 21.3.0 rA)rrrrs r"rrrr#c.\rSrSr\"5rSrSrSrg)_MaxLengthValidatoric[U5UR:a3SURSURS[U53n[U5eg)r. Length of 'z ' must be <= rN)len max_lengthr5rWr8s r"r>_MaxLengthValidator.__call__H u: ' {-7H3u:,WCS/ ! (r#c"SURS3$)NzrDrLr%r#r"rrJ"= rN)r min_lengthr5rWr8s r"r>_MinLengthValidator.__call__rr#c"SURS3$)NzrDrLr%r#r"rrrr#rc[U5$)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"rrrr#c.\rSrSr\"5rSrSrSrg)_SubclassOfValidatori,c[X0R5(d:SURSUR<SU<S3n[UUURU5eg)r.r/z' must be a subclass of r1r2N) issubclassr4r5r7r8s r"r>_SubclassOfValidator.__call__0sY%++dii[ 8 VE9TVWC   ,r#c$SUR<S3$)Nz _NotValidator.__call__bsu  NN4u -"nn"nn   ~~   sA##A65A6c@SUR<SUR<S3$)Nz>*rDrLr%r#r"rrRsOI ! -  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|r7r)rur=rs r"rrws8:!)$   33 !L !s  ))c.\rSrSr\"5rSrSrSrg) _OrValidatoricURH nU"XU5 g SUR<SU<3n[U5e![a M=f=f)NzNone of z satisfied for value ) validatorsrrW)r9r:r;r<vr=s r"r>_OrValidator.__call__s\A $e$ !++@ Jo   s = A  A c$SUR<S3$)NzrDrLr%r#r"rrsJ >r#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 )extendr3rrr|)rvalsrs r"rrsD& D  Jq,$?$?ALLaSI d $$r#)rNrs)5__doc__rrb contextlibrr_configrr_makerr r r convertersr exceptionsr __all__rrrr+rrRrrprr~rrrrrrrrrrrrrrrrrrrrWr7rrrr%r#r"rs %;55'( .%$ $!!"E40AA1A(&"E$d+FF,F*-4`E40 F F1 F)*E40JJ1J. /FED1))2)* " E40  1 8?(E40rr1r(K(E$d+CC,C" 3 4 4 3E$d+ < <, < 'E$d+ < <, < 'E40AA1A(&"E40!]!]1!]H J +B!4HE40>>1>&%r#