o 诪gNN@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 dQd+d,Z!e ddddGd-d.d.Z"dQd/d0Z#e ddddGd1d2d2Z$d3d4Z%d5d6Z&d7d8Z'd9d:Z(e ddddGd;d<d<Z)d=d>Z*e ddddGd?d@d@Z+dAdBZ,e ddddGdCdDdDZ-dEdFZ.e ddddGdGdHdHZ/de0e1fdIdJdKZ2e ddddGdLdMdMZ3dNdOZ4dS)Rz 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_optionalor_ set_disabledcCst| dS)a Globally disable or enable running validators. By default, they are run. Args: disabled (bool): If `True`, disable running all validators. .. warning:: This function is not thread-safe! .. versionadded:: 21.3.0 Nr)rr K/var/www/html/chatdoc2/venv/lib/python3.10/site-packages/attr/validators.pyr*srcCst S)z Return a bool indicating whether validators are currently disabled or not. Returns: bool:`True` if validators are currently disabled. .. versionadded:: 21.3.0 )rr r r r!r<s rccs*tdz dVWtddStdw)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!rHs  rFT)reprslots unsafe_hashc@"eZdZeZddZddZdS)_InstanceOfValidatorc CsDt||js d|jd|jd|d|jd }t|||j|dS)P We use a callable class to be able to change the ``__repr__``. ' ' must be  (got z that is a ).N) isinstancetypename __class__ TypeErrorselfinstattrvaluemsgr r r!__call__^s $z_InstanceOfValidator.__call__cCd|jdS)Nz r-r2r r r!__repr__kz_InstanceOfValidator.__repr__N__name__ __module__ __qualname__r r-r7r<r r r r!r&Z r&cCt|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). Args: type (type | tuple[type]): The type to check for. Raises: TypeError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected type, and the value it got. )r&r:r r r!ror)r"frozenr#c@s(eZdZeZeZddZddZdS)_MatchesReValidatorcCs<||sd|jd|jjd|d}t|||j|dS)r'r(z' must match regex z (z doesn't)N) match_funcr.pattern ValueErrorr1r r r!r7s z_MatchesReValidator.__call__cCr8)Nz"szmatches_re..zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchformatjoinsortedsetrIr,rr0compilerF)regexflagsfunc valid_funcsr6rHrGr r r!rs(     rc@r%)_OptionalValidatorcCs|durdS||||dSN validatorr2r3r4r5r r r!r7sz_OptionalValidator.__call__cCr8)Nzr]r;r r r!r<r=z_OptionalValidator.__repr__N)r?r@rAr r^r7r<r r r r!r[s r[cCs"t|ttfr tt|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. Args: validator (typing.Callable | tuple[typing.Callable] | list[typing.Callable]): 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,listtupler[rr]r r r!rs rc@s,eZdZeZeddZddZddZdS) _InValidatorF)hashcCsZz||jv}Wn tyd}Ynw|s+d|jd|jd|d}t|||j|dS)NFr(z ' must be in r*))optionsr0r._original_optionsrI)r2r3r4r5 in_optionsr6r r r!r7s z_InValidator.__call__cCr8)Nzr r;r r r!r<6sz_IsCallableValidator.__repr__N)r?r@rAr7r<r r r r!rj$s rjcCstS)a 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. )rjr r r r!r:s rc@s:eZdZeedZedeedZddZddZ dS) _DeepIterabler]Ndefaultr^cCs4|jdur |||||D] }||||qdSr'Niterable_validatormember_validator)r2r3r4r5memberr r r!r7Qs z_DeepIterable.__call__cCs.|jdurdnd|j}d|d|jdS)N z=)rrrrr r r!rrrcCr)a  A validator that raises `ValueError` if the initializer is called with a number smaller or equal to *val*. The validator uses `operator.ge` to compare the values. Args: val: Exclusive lower bound for values .. versionadded:: 21.3.0 r9)rrrrr r r!rrrc@r%)_MaxLengthValidatorcCs8t||jkrd|jd|jdt|}t|dS)r' Length of 'z ' must be <= rN)len max_lengthr.rIr1r r r!r7z_MaxLengthValidator.__call__cCd|jdS)Nz= rN)r min_lengthr.rIr1r r r!r7rz_MinLengthValidator.__call__cCr)Nzr r r r!r,rBrcCrC)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). Args: type (type | tuple[type, ...]): The type(s) to check for. Raises: TypeError: With a human readable error message, the attribute (of type `attrs.Attribute`), the expected type, and the value it got. )rr:r r r! _subclass_ofArDrc@sJeZdZeZeeddZeeee e e ddZ ddZ ddZd S) _NotValidatorzCnot_ validator child '{validator!r}' did not raise a captured error) converterryr]cCsNz ||||Wn |jyYdSwt|jj|j|jd||j||j)Nr^ exc_types)r^rrIr6rRr_r r r!r7bsz_NotValidator.__call__cCr)Nzsp         0  #         $ $