q&fAHdZddlZddlZddlmZddlmZmZddlm Z m Z m Z m Z ddl mZ ejZgd Zd Zd Zed Ze d ddGddZdZe d ddGddZd5dZe d ddGddZdZe d ddGddZdZe d ddGddZdZ e d d dGd d!Z!d"Z"e d ddGd#d$Z#d6d%Z$e d ddGd&d'Z%d6d(Z&e d ddGd)d*Z'd+Z(d,Z)d-Z*d.Z+e d ddGd/d0Z,d1Z-e d ddGd2d3Z.d4Z/y#e$reej$dZYhwxYw)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_disabledct| y)a 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|$ct S)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#bKtd dtdy#tdwxYww)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&eZdZeZdZdZy)_InstanceOfValidatorct||jsItdj|j|j|j |||j|y)P 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__selfinstattrr/s r __call__z_InstanceOfValidator.__call__bs_%+%v ?? &     ,r!c:dj|jS)Nz)r-)r2r-r5s r __repr__z_InstanceOfValidator.__repr__ts":AAB  r!N)__name__ __module__ __qualname__r r-r8r<r#r!r r)r)^s 8D$ r!r)ct|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). :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&c4eZdZeZeZdZdZy)_MatchesReValidatorc|j|sHtdj|j|jj|||j|y)r+z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r,patternr/N) match_func ValueErrorr2r,rEr4s r r8z_MatchesReValidator.__call__sZu%''-vDLL,@,@(.(  &r!c:dj|jS)Nz.)rE)r2rEr;s r r<z_MatchesReValidator.__repr__s"?FFLLG  r!N)r=r>r?r rErFr8r<r#r!r rCrCshGJ  r!rCc tjdtjtjf}||vrBt dj dj tdt|Dt|tr|r td|}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*. :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, c3DK|]}|xr |jxsdyw)NoneN)r=).0es r zmatches_re..s&78(ajj2F2s zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchrGr2joinsortedsetr0Patternr1compilerC)regexflagsfunc valid_funcsrErFs r rrs <<ryy"((;K ; ' . . tdj|j|j|||j|y)r+z<'{name}' must provide {interface!r} which {value!r} doesn't.)r, interfacer/N)r_ providedByr1r2r,r4s r r8z_ProvidesValidator.__call__sZ~~((/!6dnnE" 0r!c:dj|jS)Nz0r_)r2r_r;s r r<z_ProvidesValidator.__repr__s"AHHnnI  r!N)r=r>r?r r_r8r<r#r!r r]r]sI  r!r]ct|S)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. )r]rbs r rrs i ((r!c&eZdZeZdZdZy)_OptionalValidatorc0|y|j|||yN validatorr4s r r8z_OptionalValidator.__call__s =  tT5)r!cLdjt|jS)Nz')what)r2r%rir;s r r<z_OptionalValidator.__repr__s'8??dnn%@  r!N)r=r>r?r rir8r<r#r!r reresI*  r!rec`t|trtt|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. :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. )r0listrerrhs r rrs))T"!- ":;; i ((r!c&eZdZeZdZdZy) _InValidatorc ||jv}|s>tdj|j|j|||j|y#t$rd}YNwxYw)NFz/'{name}' must be in {options!r} (got {value!r}))r,optionsr/)rqr1rGr2r,)r5r6r7r/ in_optionss r r8z_InValidator.__call__$st $,,.JAHHDLLI    J sA AAc:dj|jS)Nz(rq)r2rqr;s r r<z_InValidator.__repr__4s"9@@LLA  r!N)r=r>r?r rqr8r<r#r!r roro shG  r!roct|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``. :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. )rorts r rr:s&   r!ceZdZdZdZy)_IsCallableValidatorct|s5d}t|j|j||j|y)r+z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r,r/r.)msgr/N)callabler r2r,r3)r5r6r7r/messages r r8z_IsCallableValidator.__call__RsN8 #NN%#   r!cy)Nzr#r;s r r<z_IsCallableValidator.__repr__bs(r!N)r=r>r?r8r<r#r!r rwrwPs  )r!rwctS)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. )rwr#r!r rrfs  !!r!c^eZdZeeZedeeZdZdZ y) _DeepIterablerhNdefaultricv|j|j||||D]}|j|||yr+N)iterable_validatormember_validator)r5r6r7r/members r r8z_DeepIterable.__call__|sC  " " .  # #D$ 6 6F  ! !$f 5 6r!c|jdndj|j}dj||jS)Nr z {iterable!r})iterablezJ)iterable_identifierr)rr2r)r5rs r r<z_DeepIterable.__repr__sV&&.  ''1H1H'I   ( & 3((   r!) r=r>r?r rrrrr8r<r#r!r rrus0 6 76  r!rcVt|ttfrt|}t ||S)a4 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 )r0rmtuplerr)rrs r r r s."T5M2!12 )+= >>r!czeZdZeeZeeZedeeZdZ dZ y) _DeepMappingrhNrc|j|j||||D]+}|j||||j||||-yr)mapping_validator key_validatorvalue_validator)r5r6r7r/keys r r8z_DeepMapping.__call__sY  ! ! -  " "4u 5 9C   tT3 /  tU3Z 8 9r!cPdj|j|jS)NzA)rr/)r2rrr;s r r<z_DeepMapping.__repr__s% O &T''t/C/C& D Er!) r=r>r?r rrrrrr8r<r#r!r rrs9[]3M{}5Otx 7NO 9Er!rct|||S)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!cBeZdZeZeZeZdZdZy)_NumberValidatorc|j||js)rr)r2rrr;s r r<z_NumberValidator.__repr__s'/66djj7  r!N) r=r>r?r rrrr8r<r#r!r rrs! HEJ8L  r!rc8t|dtjS)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!c8t|dtjS)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!c8t|dtjS)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!c8t|dtjS)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&eZdZeZdZdZy)_MaxLengthValidatorc t||jkDr:tdj|j|jt|y)r+z*Length of '{name}' must be <= {max}: {len})r,maxlenN)r max_lengthrGr2r,r4s r r8z_MaxLengthValidator.__call__M u: '<CCSZD  (r!c:dj|jS)Nz)r)r2rr;s r r<z_MaxLengthValidator.__repr__&.55$//5JJr!N)r=r>r?r rr8r<r#r!r rrJ Kr!rct|S)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&eZdZeZdZdZy)_MinLengthValidatorc t||jkr:tdj|j|jt|y)r+z*Length of '{name}' must be => {min}: {len})r,minrN)r min_lengthrGr2r,r4s r r8z_MinLengthValidator.__call__:rr!c:dj|jS)Nz)r)r2rr;s r r<z_MinLengthValidator.__repr__Err!N)r=r>r?r rr8r<r#r!r rr6rr!rct|S)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!)rNrg)0__doc__rrO contextlibr_configrr_makerrr r exceptionsr rVAttributeErrorr-rW__all__rrrr)rrCrr]rrerrorrwrrr rrrrrrrrrrrr#r!r rsA  %;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 FF! F!