a 1$eP@sdZddlZddlZddlmZddlmZddlmZmZddl m Z m Z m Z m Z ddlmZdd lmZgd Zd d Zd dZeddZe ddddGdddZddZe ddddGdddZdPddZe ddddGdddZdd Ze ddddGd!d"d"Zd#d$Ze ddddGd%d&d&Zd'd(Ze ddddGd)d*d*Z d+d,Z!e ddddGd-d.d.Z"dQd/d0Z#e ddddGd1d2d2Z$dRd3d4Z%e ddddGd5d6d6Z&d7d8Z'd9d:Z(d;d<Z)d=d>Z*e ddddGd?d@d@Z+dAdBZ,e ddddGdCdDdDZ-dEdFZ.e ddddGdGdHdHZ/dIdJZ0e ddddGdKdLdLZ1de2e3fdMdNdOZ4dS)Sz 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_disabledcCst| 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)rr K/var/www/html/django/DPS/env/lib/python3.9/site-packages/attr/validators.pyr+srcCst 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 r r!r=s rccs*tdzdVWtdn td0dS)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 r!rIs rFT)reprslotshashc@s"eZdZeZddZddZdS)_InstanceOfValidatorcCs4t||js0tdj|j|j|j|d||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( TypeErrorformatr' __class__selfinstattrr*r r r!__call___s z_InstanceOfValidator.__call__cCsdj|jdS)Nz)r(r-r(r0r r r!__repr__qsz_InstanceOfValidator.__repr__N__name__ __module__ __qualname__r r(r3r7r r r r!r%[sr%cCst|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%r4r r r!rws r)r"frozenr#c@s(eZdZeZeZddZddZdS)_MatchesReValidatorcCs0||s,tdj|j|jj|d||j|dS)r&z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r'patternr*N) match_func ValueErrorr-r'r>r/r r r!r3s  z_MatchesReValidator.__call__cCsdj|jdS)Nz.)r>)r-r>r6r r r!r7sz_MatchesReValidator.__repr__N)r9r:r;r r>r?r3r7r r r r!r=sr=c Cstjdtjtjf}||vr@tddtddt|Dt |t r\|rVt d|}n t ||}|tjurz|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, css|]}|r|jpdVqdS)NoneN)r9).0er r r! szmatches_re..zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchr@r-joinsortedsetr+rr,compiler=)regexflagsfunc valid_funcsr>r?r r r!rs0    rc@s"eZdZeZddZddZdS)_ProvidesValidatorcCs0|j|s,tdj|j|j|d||j|dS)r&z<'{name}' must provide {interface!r} which {value!r} doesn't.)r' interfacer*N)rR providedByr,r-r'r/r r r!r3s  z_ProvidesValidator.__call__cCsdj|jdS)Nz0)rR)r-rRr6r r r!r7sz_ProvidesValidator.__repr__N)r9r:r;r rRr3r7r r r r!rQsrQcCs ddl}|jdtddt|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)warningswarnDeprecationWarningrQ)rRrVr r r!rsrc@s"eZdZeZddZddZdS)_OptionalValidatorcCs|dur dS||||dS)N validatorr/r r r!r3 sz_OptionalValidator.__call__cCsdjt|jdS)Nz')what)r-r"r[r6r r r!r7sz_OptionalValidator.__repr__N)r9r:r;r r[r3r7r r r r!rYsrYcCs"t|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. )r+listtuplerYrrZr r r!rs  rc@s"eZdZeZddZddZdS) _InValidatorcCsNz||jv}Wnty$d}Yn0|sJtdj|j|j|d||j|dS)NFz/'{name}' must be in {options!r} (got {value!r}))r'optionsr*)r`r,r@r-r')r0r1r2r* in_optionsr r r!r3,s   z_InValidator.__call__cCsdj|jdS)Nz(r`)r-r`r6r r r!r7<sz_InValidator.__repr__N)r9r:r;r r`r3r7r r r r!r_(sr_cCst|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. )r_rbr r r!rBsrc@seZdZddZddZdS)_IsCallableValidatorcCs,t|s(d}t|j|j||jd|ddS)r&z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r'r*r))msgr*N)callabler r-r'r.)r0r1r2r*messager r r!r3Zs z_IsCallableValidator.__call__cCsdS)Nzr r6r r r!r7jsz_IsCallableValidator.__repr__N)r9r:r;r3r7r r r r!rcXsrccCstS)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. )rcr r r r!rns rc@s:eZdZeedZedeedZddZddZ dS) _DeepIterablerZNdefaultr[cCs4|jdur|||||D]}||||qdSr&N)iterable_validatormember_validator)r0r1r2r*memberr r r!r3s z_DeepIterable.__call__cCs*|jdurdn d|j}dj||jdS)N zJ)iterable_identifierrm)rkr-rl)r0rpr r r!r7s z_DeepIterable.__repr__) r9r:r;r rrlrrkr3r7r r r r!rg}s    rgcCs t|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 )r+r]r^rrgrlrkr r r!r s r c@sFeZdZeedZeedZedeedZddZ ddZ dS) _DeepMappingrZNrhcCsF|jdur|||||D]$}|||||||||qdSrj)mapping_validator key_validatorvalue_validator)r0r1r2r*keyr r r!r3s  z_DeepMapping.__call__cCsdj|j|jdS)NzA)rvr*)r-rtrur6r r r!r7sz_DeepMapping.__repr__) r9r:r;r rrtrurrsr3r7r r r r!rrs    rrcCs 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 )rr)rtrursr r r!rs rc@s.eZdZeZeZeZddZddZdS)_NumberValidatorcCs.|||js*tdj|j|j|j|ddS)r&z&'{name}' must be {op} {bound}: {value})r'opboundr*N) compare_funcryr@r-r' compare_opr/r r r!r3sz_NumberValidator.__call__cCsdj|j|jdS)Nz)rxry)r-r{ryr6r r r!r7sz_NumberValidator.__repr__N) r9r:r;r ryr{rzr3r7r r r r!rws rwcCst|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 <)rwoperatorrvalr r r!rs rcCst|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<=)rwr}rr~r r r!rs rcCst|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>=)rwr}rr~r r r!rs rcCst|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 >)rwr}rr~r r r!rs rc@s"eZdZeZddZddZdS)_MaxLengthValidatorcCs.t||jkr*tdj|j|jt|ddS)r&z*Length of '{name}' must be <= {max}: {len})r'maxlenN)r max_lengthr@r-r'r/r r r!r3#s z_MaxLengthValidator.__call__cCsd|jdS)Nz {min}: {len})r'minrN)r min_lengthr@r-r'r/r r r!r3Bs z_MinLengthValidator.__call__cCsd|jdS)Nzs rcCst|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 )rrr r r!rQs rc@s"eZdZeZddZddZdS)_SubclassOfValidatorcCs0t||js,tdj|j|j|d||j|dS)r&z8'{name}' must be a subclass of {type!r} (got {value!r}).)r'r(r*N) issubclassr(r,r-r'r/r r r!r3as z_SubclassOfValidator.__call__cCsdj|jdS)Nz)r4r5r6r r r!r7rsz_SubclassOfValidator.__repr__Nr8r r r r!r]srcCst|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. )rr4r r r! _subclass_ofxs rc@sJeZdZeZeeddZeeee e e ddZ ddZ ddZd S) _NotValidatorzCnot_ validator child '{validator!r}' did not raise a captured error) converterrqrZcCsPz||||Wn|jy&Yn&0t|jj|j|jd||j||jdS)N)r[ exc_types)r[rr@rdr-r/r r r!r3sz_NotValidator.__call__cCsdj|j|jdS)Nz;)r\r)r-r[rr6r r r!r7s z_NotValidator.__repr__N)r9r:r;r r[r rdr r Exceptionrr^rr3r7r r r r!rsr)rdrcCs2z t|}Wnty$|f}Yn0t|||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 )r^r,r)r[rdrr r r!rs    r)rN)N)N)5__doc__r}rE contextlibrr_configrr_makerrr r convertersr exceptionsr __all__rrrr%rr=rrQrrYrr_rrcrrgr rrrrwrrrrrrrrrrrr@r,rr r r r!sn         0                )