6hASrSSKrSSKrSSKJr SSKJrJr SSKJ r J r J r J r SSK Jr \Rr/S QrS rS r\S 5r\ "S SSS9"SS55rSr\ "S SSS9"SS55rS5Sjr\ "S SSS9"SS55rSr\ "S SSS9"SS55rSr\ "S SSS9"SS55rSr \ "S S SS9"S S!55r!S"r"\ "S SSS9"S#S$55r#S6S%jr$\ "S SSS9"S&S'55r%S6S(jr&\ "S SSS9"S)S*55r'S+r(S,r)S-r*S.r+\ "S SSS9"S/S055r,S1r-\ "S SSS9"S2S355r.S4r/g!\a \"\R$"S55rGNKf=f)7z Commonly useful validators. N)contextmanager)get_run_validatorsset_run_validators) _AndValidatorand_attribattrs)NotCallableError)r deep_iterable deep_mappingdisabledge get_disabledgtin_ instance_of is_callablelelt matches_remax_lenmin_lenoptionalprovides set_disabledc$[U(+5 g)z Globally disable or enable running validators. By default, they are run. :param disabled: If ``True``, disable running all validators. :type disabled: bool .. warning:: This function is not thread-safe! .. versionadded:: 21.3.0 Nr)rs F/usr/lib/python3/dist-packages/mercurial/thirdparty/attr/validators.pyrr.s8|$c [5(+$)z Return a bool indicating whether validators are currently disabled or not. :return: ``True`` if validators are currently disabled. :rtype: bool .. 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 FNTrr#r!r rrLs(u! 4 4 s / / ,/FT)reprslotshashc.\rSrSr\"5rSrSrSrg)_InstanceOfValidator^c [X0R5(dF[SRURURUR US9UURU5eg)@ We use a callable class to be able to change the ``__repr__``. z?'{name}' must be {type!r} (got {value!r} that is a {actual!r}).)nametypeactualvalueN) isinstancer. TypeErrorformatr- __class__selfinstattrr0s r __call___InstanceOfValidator.__call__bs`%++%v ?? &     ,r!c4SRURS9$)Nz)r.)r3r.r6s r __repr___InstanceOfValidator.__repr__ts":AAB  r!r#N) __name__ __module__ __qualname____firstlineno__r r.r9r>__static_attributes__r#r!r r)r)^s 8D$ r!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). :param type: The type to check for. :type type: type or tuple of types :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 rrzs  %%r!)r%frozenr&c<\rSrSr\"5r\"5rSrSrSr g)_MatchesReValidatorcURU5(dE[SRURURRUS9UURU5eg)r,z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r-patternr0N) match_func ValueErrorr3r-rKr5s r r9_MatchesReValidator.__call__s]u%%''-vDLL,@,@(.(  &r!c4SRURS9$)Nz.)rK)r3rKr=s r r>_MatchesReValidator.__repr__s"?FFLLG  r!r#N) r@rArBrCr rKrLr9r>rDr#r!r rHrHshGJ  r!rHc [RS[R[R4nX#;aB[ SR SR [S[U555555e[U[5(aU(a [S5eUnO[R"X5nU[RLa URnO,U[RLa URnO URn[XE5$)al A validator that raises `ValueError` if the initializer is called with a string that doesn't match *regex*. :param regex: a regex string or precompiled pattern to match against :param int flags: flags that will be passed to the underlying re function (default 0) :param callable func: 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)r@).0es r matches_re..s#ri)r3rir=s r r>_ProvidesValidator.__repr__s"AHHnnI  r!r#N) r@rArBrCr rir9r>rDr#r!r rfrfsI  r!rfc[U5$)a A validator that raises a `TypeError` if the initializer is called with an object that does not provide the requested *interface* (checks are performed using ``interface.providedBy(value)`` (see `zope.interface `_). :param interface: The interface to check for. :type interface: ``zope.interface.Interface`` :raises TypeError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected interface, and the value it got. )rfrms r rrs i ((r!c.\rSrSr\"5rSrSrSrg)_OptionalValidatorc0UcgURXU5 gN validatorr5s r r9_OptionalValidator.__call__s =  t5)r!cFSR[UR5S9$)Nz')what)r3r%rvr=s r r>_OptionalValidator.__repr__s'8??dnn%@  r!r#N) r@rArBrCr rvr9r>rDr#r!r rqrqsI*  r!rqcj[U[5(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. :param validator: A validator (or a list of validators) that is used for non-``None`` values. :type validator: callable or `list` of callables. .. versionadded:: 15.1.0 .. versionchanged:: 17.1.0 *validator* can be a list of validators. )r1listrqrrus r rrs,)T""!- ":;; i ((r!c.\rSrSr\"5rSrSrSrg) _InValidatori cX0R;nU(d;[SRURURUS9UURU5eg![a SnNQf=f)NFz/'{name}' must be in {options!r} (got {value!r}))r-optionsr0)rr2rMr3r-)r6r7r8r0 in_optionss r r9_InValidator.__call__$sr ,,.JAHHDLLI    J sA A"!A"c4SRURS9$)Nz(r)r3rr=s r r>_InValidator.__repr__4s"9@@LLA  r!r#N) r@rArBrCr rr9r>rDr#r!r r~r~ shG  r!r~c[U5$)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``. :param options: Allowed options. :type options: list, tuple, `enum.Enum`, ... :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. )r~rs r rr:s&   r!c \rSrSrSrSrSrg)_IsCallableValidatoriPc[U5(d.Sn[URURX3RS9US9eg)r,z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r-r0r/)msgr0N)callabler r3r-r4)r6r7r8r0messages r r9_IsCallableValidator.__call__RsN8 #NN%#   r!cg)Nzr#r=s r r>_IsCallableValidator.__repr__bs(r!r#N)r@rArBrCr9r>rDr#r!r rrPs  )r!rc[5$)aX A validator that raises a `attr.exceptions.NotCallableError` if the initializer is called with a value for this particular attribute that is not callable. .. versionadded:: 19.1.0 :raises `attr.exceptions.NotCallableError`: With a human readable error message containing the attribute (`attrs.Attribute`) name, and the value it got. )rr#r!r rrfs  !!r!cZ\rSrSr\"\"5S9r\"S\"\"55S9rSr Sr Sr g) _DeepIterableiuruNdefaultrvcxURbURXU5 UHnURXU5 M gr,N)iterable_validatormember_validator)r6r7r8r0members r r9_DeepIterable.__call__|s:  " " .  # #D 6F  ! !$f 5r!cURcSOSRURS9nSRUURS9$)Nr z {iterable!r})iterablezJ)iterable_identifierr)rr3r)r6rs r r>_DeepIterable.__repr__sV&&.  ''1H1H'I   ( & 3((   r!r#) r@rArBrCr rrrrr9r>rDr#r!r rrus0 6 76  r!rc^[U[[45(a[U6n[ X5$)a A validator that performs deep validation of an iterable. :param member_validator: Validator(s) to apply to iterable members :param iterable_validator: Validator to apply to iterable itself (optional) .. versionadded:: 19.1.0 :raises TypeError: if any sub-validators fail )r1r|tuplerr)rrs r r r s."T5M22!12 ) >>r!cp\rSrSr\"\"5S9r\"\"5S9r\"S\"\"55S9r Sr Sr Sr g) _DeepMappingiruNrcURbURXU5 UH)nURXU5 URXX45 M+ gr)mapping_validator key_validatorvalue_validator)r6r7r8r0keys r r9_DeepMapping.__call__sL  ! ! -  " "4u 5C   t3 /  UZ 8r!cJSRURURS9$)NzA)rr0)r3rrr=s r r>_DeepMapping.__repr__s% O &T''t/C/C& D Er!r#) r@rArBrCr rrrrrr9r>rDr#r!r rrs9[]3M{}5Otx 7NO 9Er!rc[XU5$)a] A validator that performs deep validation of a dictionary. :param key_validator: Validator to apply to dictionary keys :param value_validator: Validator to apply to dictionary values :param 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)_NumberValidatoric URX0R5(d9[SRURUR URUS95eg)r,z&'{name}' must be {op} {bound}: {value})r-opboundr0N) compare_funcrrMr3r- compare_opr5s r r9_NumberValidator.__call__sW   338??** @ 4r!cJSRURURS9$)Nz)rr)r3rrr=s r r>_NumberValidator.__repr__s'/66djj7  r!r#N) r@rArBrCr rrrr9r>rDr#r!r rrs! HEJ8L  r!rc8[US[R5$)z A validator that raises `ValueError` if the initializer is called with a number larger or equal to *val*. :param 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*. :param 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*. :param 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*. :param val: Exclusive lower bound for values .. versionadded:: 21.3.0 >)rrrrs r rr rr!c.\rSrSr\"5rSrSrSrg)_MaxLengthValidatoric [U5UR:a7[SRURUR[U5S95eg)r,z*Length of '{name}' must be <= {max}: {len})r-maxlenN)r max_lengthrMr3r-r5s r r9_MaxLengthValidator.__call__M u: '<CCSZD  (r!c4SRURS9$)Nz)r)r3rr=s r r>_MaxLengthValidator.__repr__&.55$//5JJr!r#N) r@rArBrCr rr9r>rDr#r!r rrJ Kr!rc[U5$)z A validator that raises `ValueError` if the initializer is called with a string or iterable that is longer than *length*. :param int length: Maximum length of the string or iterable .. versionadded:: 21.3.0 )rlengths r rr* v &&r!c.\rSrSr\"5rSrSrSrg)_MinLengthValidatori6c [U5UR:a7[SRURUR[U5S95eg)r,z*Length of '{name}' must be => {min}: {len})r-minrN)r min_lengthrMr3r-r5s r r9_MinLengthValidator.__call__:rr!c4SRURS9$)Nz)r)r3rr=s r r>_MinLengthValidator.__repr__Err!r#N) r@rArBrCr rr9r>rDr#r!r rr6rr!rc[U5$)z A validator that raises `ValueError` if the initializer is called with a string or iterable that is shorter than *length*. :param int length: Minimum length of the string or iterable .. versionadded:: 22.1.0 )rrs r rrIrr!)rNrt)0__doc__rrX contextlibr_configrr_makerrr r exceptionsr r_AttributeErrorr.r`__all__rrrr)rrHrrfrrqrr~rrrrr rrrrrrrrrrrr#r!r rs?  %;55(#jjG  ,%$ $!!"ED)  * 6 & E$d+  , 2-4`ED)  * 0)"ED)   *  )$ED)  * 2!,ET*))+)* "ED)  * >?"ED)EE*E, K E$d+  , 2 3 4 4 3E$d+KK,K$ 'E$d+KK,K$ 'k#2::b>"G#s E""FF