/JfLhdZddlZddlZddlmZddlmZddlmZmZddl 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<Z4dS)?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_disabledc&t| dS)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 R/home/alex/cs2snipeproduction/venv/lib/python3.11/site-packages/attr/validators.pyrr+s8|$$$$$c t 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#xKtd dVtddS#tdwxYw)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"rrIsMu! 4     4    s(9FT)reprslotshashc.eZdZeZdZdZdS)_InstanceOfValidatorct||js?d|j|j|j|}t |||j|dS)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/formatr. __class__ TypeErrorselfinstattrr1msgs r"__call__z_InstanceOfValidator.__call___sq%++ SZZYY [C      r#cd|jdS)Nz r/r7s r"__repr__z_InstanceOfValidator.__repr__q@$)@@@@r#N__name__ __module__ __qualname__r r/r;r@r%r#r"r+r+[sB 688D$AAAAAr#r+c t|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"rru  % %%r#)r'frozenr(cBeZdZeZeZdZdZdS)_MatchesReValidatorc||s>d|j|jj|}t |||j|dS)r-z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r.patternr1N) match_funcr3r.rL ValueErrorr6s r"r;z_MatchesReValidator.__call__smu%% MTTY (zmatches_re..s.LLaq'QZ16LLLLLLr#zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchr3joinsortedsetrNr2rr5compilerJ)regexflagsfunc valid_funcsr:rLrMs r"rrs <ry"(;K ;)00 IILL3{;K;KLLLLL     oo%!!+  !fCC.. *UE** rx]   ^ & w 3 33r#c.eZdZeZdZdZdS)_ProvidesValidatorc|j|s9d|j|j|}t |||j|dS)r-z<'{name}' must provide {interface!r} which {value!r} doesn't.)r. interfacer1N)re providedByr3r.r5r6s r"r;z_ProvidesValidator.__call__sn~((// PWWY$.XC    r#cd|jdS)Nz"`_). :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)warningswarnDeprecationWarningrc)rerks r"rrsC OOO MM   i ( ((r#c.eZdZeZdZdZdS)_OptionalValidatorc<|dS||||dSN validatorr7r8r9r1s r"r;z_OptionalValidator.__call__s( = F tT5)))))r#cd|jdS)Nzrrr?s r"r@z_OptionalValidator.__repr__sE$.EEEEr#N)rCrDrEr rsr;r@r%r#r"rorosBI*** FFFFFr#roct|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. )r2listtuplerorrrs r"rrs>)dE]++<!- ":":;;; i ( ((r#c.eZdZeZdZdZdS) _InValidatorc ||jv}n#t$rd}YnwxYw|s-d|jd|jd|d}t|||j|dS)NF'z ' must be in  (got ))optionsr5r.rN)r7r8r9r1 in_optionsr:s r"r;z_InValidator.__call__s $,.JJ   JJJ  NdiNNdlNNENNNC     s cd|jdS)Nzr%r?s r"r@z_IsCallableValidator.__repr__Zs((r#N)rCrDrEr;r@r%r#r"rrHs2 )))))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"rr^s ! !!r#c~eZdZeeZedeeZdZdZ dS) _DeepIterablerrNdefaultrscz|j|||||D]}||||dSr-Niterable_validatormember_validator)r7r8r9r1members r"r;z_DeepIterable.__call__tsY  " .  # #D$ 6 6 6 6 6F  ! !$f 5 5 5 5 6 6r#cD|jdn d|j}d|d|jdS)N z 8 8!2 8 8 8 r#) rCrDrEr rrrrr;r@r%r#r"rrmswv 666 7 7666      r#rclt|ttfr t|}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 )r2rwrxr rrrs r"rrs9"T5M223!12 )+= > >>r#ceZdZeeZeeZedeeZdZ dZ dS) _DeepMappingrrNrc|j|||||D]6}|||||||||7dSr)mapping_validator key_validatorvalue_validator)r7r8r9r1keys r"r;z_DeepMapping.__call__su  ! -  " "4u 5 5 5 9 9C   tT3 / / /  tU3Z 8 8 8 8 9 9r#cDd|j|jS)NzA)rr1)r3rrr?s r"r@z_DeepMapping.__repr__s" O &T't/C& D D Er#) rCrDrEr rrrrrr;r@r%r#r"rrsF[[]]333Mf{{}}555Otxx 7N7NOOO 9 9 9EEEEEr#rc$t|||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 J JJr#cVeZdZeZeZeZdZdZdS)_NumberValidatorc|||js,d|jd|jd|jd|}t |dS)r-r|z ' must be r: N) compare_funcboundr. compare_oprNr6s r"r;z_NumberValidator.__call__s_   33 "RdiRR4?RRTZRR5RRCS// ! " "r#c(d|jd|jdS)Nz=)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 r=)rrrrs r"rrrr#c.eZdZeZdZdZdS)_MaxLengthValidatorct||jkr1d|jd|jdt|}t|dS)r- Length of 'z ' must be <= rN)len max_lengthr.rNr6s r"r;z_MaxLengthValidator.__call__R u:: ' 'W WWWW3u::WWCS// ! ( 'r#cd|jdS)Nz= rN)r min_lengthr.rNr6s r"r;z_MinLengthValidator.__call__$rr#cd|jdS)Nzr?s r"r@z_SubclassOfValidator.__repr__MrAr#NrBr%r#r"rr<sB 688D   AAAAAr#rc t|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_ofrQrGr#ceZdZeZeedZeeee e e Z dZ dZdS) _NotValidatorzCnot_ validator child '{validator!r}' did not raise a captured error) converterrrrc ||||t|j|j|j||j||j#|j$rYdSwxYw)N)rs exc_types)rsrNr:r3rrts r"r;z_NotValidator.__call__qs  NN4u - - -"n"n    ~    DD sA A('A(cDd|j|jS)Nz;)whatr)r3rsrr?s r"r@z_NotValidator.__repr__s( I &n    r#N)rCrDrEr rsr r:rr Exceptionrrxrr;r@r%r#r"rrasI &!/ -     C -)\)44*{511   I"     r#r)r:rcl t|}n#t$r|f}YnwxYwt|||S)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 )rxr5r)rsr:rs r"rrsN4!)$$ !!!L ! C 3 33s  "")rNrq)5__doc__rrV contextlibrr_configrr_makerr r r convertersr exceptionsr __all__rrrr+rrJrrcrrorrzrrrrrrrrrrrrrrrrrrrrNr5rr%r#r"rs  %%%%%%;;;;;;;;555555555555''''''((((((   .%%%$ $ $ $!!!"ED)))AAAAAAA*)A2 & & & E$d+++FFFFFFF,+F.(4(4(4(4VED)))HHHHHHH*)H,)))6ED))) F F F F F F F*) F)))&ED)))@@@@@@@*)@,!!!,ET***)))))))+*)* " " "ED)))       *) 8????"ED)))EEEEEEE*)E, K K K K E$d+++CCCCCCC,+C" 3 3 3 4 4 4 4 4 4 3 3 3E$d+++ < < < < < < <,+ < ' ' 'E$d+++ < < < < < < <,+ < ' ' 'ED)))AAAAAAA*)A( & & & ED)))& & & & & & & *)& R J +B4444444r#