2iPvdZddlZddlZddlmZddlmZddlmZmZddl m Z m Z m Z m Z ddlmZdd lmZgd Zd Zd Zed Ze dddGddZdZe dddGddZd=dZe dddGddZdZe dddGddZdZe dddGddZd Ze dddGd!d"Z d#Z!e dddGd$d%Z"d>d&Z#e dddGd'd(Z$d>d)Z%e dddGd*d+Z&d,Z'd-Z(d.Z)d/Z*e dddGd0d1Z+d2Z,e dddGd3d4Z-d5Z.e dddGd6d7Z/d8Z0e dddGd9d:Z1de2e3fd;d<Z4y)?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_optionalprovides 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/var/www/html/acx/venv/lib/python3.12/site-packages/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 FNTr!r%r#r"rrIs)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__selfinstattrr1s r"__call__z_InstanceOfValidator.__call___s_%+%v ?? &     ,r#c:dj|jS)Nz)r/r4r/r7s r"__repr__z_InstanceOfValidator.__repr__q":AAB  r#N__name__ __module__ __qualname__r r/r:r?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 type :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"rrw  %%r#)r'frozenr(c4eZdZeZeZdZdZy)_MatchesReValidatorc|j|sHtdj|j|jj|||j|y)r-z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r.patternr1N) match_func ValueErrorr4r.rKr6s r"r:z_MatchesReValidator.__call__sZu%''-vDLL,@,@(.(  &r#c:dj|jS)Nz.)rK)r4rKr>s r"r?z_MatchesReValidator.__repr__s"?FFLLG  r#N)rBrCrDr rKrLr:r?r%r#r"rIrIshGJ  r#rIc 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)rB).0es r" zmatches_re..s&78(ajj2F2s zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchrMr4joinsortedsetr2rr3compilerI)regexflagsfunc valid_funcsrKrLs r"rrs <<ryy"((;K ; ' . . tdj|j|j|||j|y)r-z<'{name}' must provide {interface!r} which {value!r} doesn't.)r. interfacer1N)rd providedByr3r4r.r6s r"r:z_ProvidesValidator.__call__sZ~~((/!6dnnE" 0r#c:dj|jS)Nz0)rd)r4rdr>s r"r?z_ProvidesValidator.__repr__s"AHHnnI  r#N)rBrCrDr rdr:r?r%r#r"rbrbsI  r#rbcPddl}|jdtdt|S)aE 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. .. deprecated:: 23.1.0 rNzZattrs's zope-interface support is deprecated and will be removed in, or after, April 2024.) stacklevel)warningswarnDeprecationWarningrb)rdrjs r"rrs0  MM   i ((r#c&eZdZeZdZdZy)_OptionalValidatorc0|y|j|||yN validatorr6s r"r:z_OptionalValidator.__call__ s =  tT5)r#cLdjt|jS)Nz')what)r4r'rrr>s r"r?z_OptionalValidator.__repr__s'8??dnn%@  r#N)rBrCrDr rrr:r?r%r#r"rnrnsI*  r#rnclt|ttfrtt |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 Callable | tuple[Callable] | list[Callable] validator: 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. )r2listtuplernrrqs r"rrs-)dE]+!- ":;; 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.optionsr1)r{r3rMr4r.)r7r8r9r1 in_optionss r"r:z_InValidator.__call__,st $,,.JAHHDLLI    J sA AAc:dj|jS)Nz(r{)r4r{r>s r"r?z_InValidator.__repr__<s"9@@LLA  r#N)rBrCrDr r{r:r?r%r#r"ryry(shG  r#ryct|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. )ryr~s r"rrBs&   r#ceZdZdZdZy)_IsCallableValidatorct|s5d}t|j|j||j|y)r-z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r.r1r0)msgr1N)callabler r4r.r5)r7r8r9r1messages r"r:z_IsCallableValidator.__call__ZsN8 #NN%#   r#cy)Nzr%r>s r"r?z_IsCallableValidator.__repr__js(r#N)rBrCrDr:r?r%r#r"rrXs  )r#rctS)ax 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"rrns  !!r#c^eZdZeeZedeeZdZdZ y) _DeepIterablerqNdefaultrrcv|j|j||||D]}|j|||yr-N)iterable_validatormember_validator)r7r8r9r1members r"r:z_DeepIterable.__call__sC  " " .  # #D$ 6 6F  ! !$f 5 6r#cv|jdnd|j}dj||jS)N zJ)iterable_identifierr)rr4r)r7rs r"r?z_DeepIterable.__repr__sP&&. T,,/0   ( & 3((   r#) rBrCrDr rrrrr:r?r%r#r"rr}s0 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 )r2rvrwr rrrs r"rrs."T5M2!12 )+= >>r#czeZdZeeZeeZedeeZdZ dZ y) _DeepMappingrqNrc|j|j||||D]+}|j||||j||||-yr)mapping_validator key_validatorvalue_validator)r7r8r9r1keys r"r:z_DeepMapping.__call__sY  ! ! -  " "4u 5 9C   tT3 /  tU3Z 8 9r#cPdj|j|jS)NzA)rr1)r4rrr>s r"r?z_DeepMapping.__repr__s% O &T''t/C/C& D Er#) rBrCrDr rrrrrr:r?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)r4rrr>s r"r?z_NumberValidator.__repr__s'/66djj7  r#N) rBrCrDr rrrr:r?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"rrrr#c&eZdZeZdZdZy)_MaxLengthValidatorc t||jkDr:tdj|j|jt|y)r-z*Length of '{name}' must be <= {max}: {len})r.maxlenN)r max_lengthrMr4r.r6s r"r:z_MaxLengthValidator.__call__#M u: '<CCSZD  (r#c"d|jdS)Nzs r"r?z_MaxLengthValidator.__repr__.((9;;r#N)rBrCrDr rr:r?r%r#r"rrJ  {min}: {len})r.minrN)r min_lengthrMr4r.r6s r"r:z_MinLengthValidator.__call__Brr#c"d|jdS)Nzs r"r?z_MinLengthValidator.__repr__Mrr#N)rBrCrDr rr:r?r%r#r"rr>rr#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"rrQrr#c&eZdZeZdZdZy)_SubclassOfValidatorct||js>tdj|j|j|||j|y)r-z8'{name}' must be a subclass of {type!r} (got {value!r}).)r.r/r1N) issubclassr/r3r4r.r6s r"r:z_SubclassOfValidator.__call__asX%+##)6$*$    ,r#c:dj|jS)Nz)r<r=r>s r"r?z_SubclassOfValidator.__repr__rr@r#NrAr%r#r"rr]s 8D" r#rct|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 `issubclass` 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. )rr<s r" _subclass_ofrxrFr#c~eZdZeZeedZeeee e e Z dZ dZy) _NotValidatorzCnot_ validator child '{validator!r}' did not raise a captured error) converterrrqc |j|||t|jj|j|j||j||j#|j$rYywxYw)N)rr exc_types)rrrMrr4rr6s r"r:z_NotValidator.__call__sw  NN4u -"nn"nn   ~~   sA''A98A9cPdj|j|jS)Nz;)rtr)r4rrrr>s r"r?z_NotValidator.__repr__s' L &nn   r#N)rBrCrDr rrr rrr Exceptionrrwrr:r?r%r#r"rrsNI ! -  C ))4*51 I" r#r)rrcX t|}t|||S#t$r|f}YwxYw)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_(...))``. :param validator: A validator to be logically inverted. :param msg: Message to raise if validator fails. Formatted with keys ``exc_types`` and ``validator``. :type msg: str :param exc_types: 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 )rwr3r)rrrrs r"rrs:4!)$  C 33 !L !s  )))rNrp)5__doc__rrU contextlibrr_configrr_makerr r r convertersr exceptionsr __all__rrrr+rrIrrbrrnrryrrrrrrrrrrrrrrrrrrrrMr3rr%r#r"rsh  %;55'( .%$ $!!"ED)  * 6 & E$d+  , 2-4`ED)  * 0)6ED)   *  )&ED)  * 2!,ET*))+)* "ED)  * >?"ED)EE*E, K E$d+  , 2 3 4 4 3E$d+<<,<$ 'E$d+<<,<$ 'ED)  * 4 & ED)& & *& R J +B4r#