B ^u_�,� @s�dZddlmZmZmZddlZddlmZmZm Z m Z ddlmZddd d ddd ddg Z e dddd�Gdd�de��Zdd�Ze dddd�Gdd�de��Zd,dd �Ze dddd�Gdd�de��Zdd�Ze dddd�Gdd�de��Zdd�Ze dddd�Gd d!�d!e��Zd"d �Ze dddd�Gd#d$�d$e��Zd%d�Ze dddd�Gd&d'�d'e��Zd-d(d�Ze dddd�Gd)d*�d*e��Zd.d+d �ZdS)/z Commonly useful validators. �)�absolute_import�division�print_functionN�)� _AndValidator�and_�attrib�attrs)�NotCallableErrorr� deep_iterable�deep_mapping�in_�instance_of�is_callable� matches_re�optional�providesFT)�repr�slots�hashc@s"eZdZe�Zdd�Zdd�ZdS)�_InstanceOfValidatorcCs4t||j�s0tdj|j|j|j|d�||j|��dS)zP 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}).)�name�type�actual�valueN)� isinstancer� TypeError�formatr� __class__)�self�inst�attrr�r"�@/opt/alt/python37/lib/python3.7/site-packages/attr/validators.py�__call__sz_InstanceOfValidator.__call__cCsdj|jd�S)Nz))r)rr)rr"r"r#�__repr__0sz_InstanceOfValidator.__repr__N)�__name__� __module__�__qualname__rrr$r%r"r"r"r#rsrcCst|�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 `attr.Attribute`), the expected type, and the value it got. )r)rr"r"r#r6s )r�frozenrc@s.eZdZe�Ze�Ze�Zdd�Zdd�ZdS)�_MatchesReValidatorcCs0|�|�s,tdj|j|jj|d�||j|��dS)zP We use a callable class to be able to change the ``__repr__``. z7'{name}' must match regex {regex!r} ({value!r} doesn't))r�regexrN)� match_func� ValueErrorrrr+�pattern)rr r!rr"r"r#r$Ls z_MatchesReValidator.__call__cCsdj|jd�S)Nz,)r+)rr+)rr"r"r#r%[sz_MatchesReValidator.__repr__N) r&r'r(rr+�flagsr,r$r%r"r"r"r#r*Fs r*cCs�ttdd�}|dtjtjf}||krJtdd�tdd�t|�D��f��t�||�}|tjkrh|j}n6|tjkrz|j}n$|r�|j }nt�d� |�|�}|j}t|||�S)a} A validator that raises `ValueError` if the initializer is called with a string that doesn't match *regex*. :param str regex: a regex string 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 (options are `re.fullmatch`, `re.search`, `re.match`, default is ``None`` which means either `re.fullmatch` or an emulation of it on Python 2). For performance reasons, they won't be used directly but on a pre-`re.compile`\ ed pattern. .. versionadded:: 19.2.0 � fullmatchNz'func' must be one of %s.z, css|]}|r|jpdVqdS)�NoneN)r&)�.0�er"r"r#� yszmatches_re..z(?:{})\Z)�getattr�re�search�matchr-�join�sorted�set�compiler0rr*)r+r/�funcr0Zvalid_funcsr.r,r"r"r#ras$ c@s"eZdZe�Zdd�Zdd�ZdS)�_ProvidesValidatorcCs0|j�|�s,tdj|j|j|d�||j|��dS)zP We use a callable class to be able to change the ``__repr__``. z<'{name}' must provide {interface!r} which {value!r} doesn't.)r� interfacerN)r?Z providedByrrr)rr r!rr"r"r#r$�sz_ProvidesValidator.__call__cCsdj|jd�S)Nz0)r?)rr?)rr"r"r#r%�sz_ProvidesValidator.__repr__N)r&r'r(rr?r$r%r"r"r"r#r>�sr>cCst|�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 `attr.Attribute`), the expected interface, and the value it got. )r>)r?r"r"r#r�sc@s"eZdZe�Zdd�Zdd�ZdS)�_OptionalValidatorcCs|dkrdS|�|||�dS)N)� validator)rr r!rr"r"r#r$�sz_OptionalValidator.__call__cCsdjt|j�d�S)Nz')Zwhat)rrrA)rr"r"r#r%�sz_OptionalValidator.__repr__N)r&r'r(rrAr$r%r"r"r"r#r@�sr@cCst|t�rtt|��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. )r�listr@r)rAr"r"r#r�s c@s"eZdZe�Zdd�Zdd�ZdS)�_InValidatorcCsHy||jk}Wntk r&d}YnX|sDtdj|j|j|d��dS)NFz/'{name}' must be in {options!r} (got {value!r}))r�optionsr)rDrr-rr)rr r!rZ in_optionsr"r"r#r$�s z_InValidator.__call__cCsdj|jd�S)Nz()rD)rrD)rr"r"r#r%�sz_InValidator.__repr__N)r&r'r(rrDr$r%r"r"r"r#rC�s rCcCst|�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 `attr.Attribute`), the expected options, and the value it got. .. versionadded:: 17.1.0 )rC)rDr"r"r#r �sc@seZdZdd�Zdd�ZdS)�_IsCallableValidatorcCs,t|�s(d}t|j|j||jd�|d��dS)zP We use a callable class to be able to change the ``__repr__``. z?'{name}' must be callable (got {value!r} that is a {actual!r}).)rrr)�msgrN)�callabler rrr)rr r!r�messager"r"r#r$sz_IsCallableValidator.__call__cCsdS)Nzr")rr"r"r#r%sz_IsCallableValidator.__repr__N)r&r'r(r$r%r"r"r"r#rEsrEcCst�S)aw 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 (`attr.Attribute`) name, and the value it got. )rEr"r"r"r#rsc@s:eZdZee�d�Zedee��d�Zdd�Zdd�Z dS)� _DeepIterable)rAN)�defaultrAcCs8|jdk r|�|||�x|D]}|�|||�qWdS)zP We use a callable class to be able to change the ``__repr__``. N)�iterable_validator�member_validator)rr r!r�memberr"r"r#r$/s z_DeepIterable.__call__cCs,|jdkrdndj|jd�}dj||jd�S)N�z {iterable!r})�iterablezJ)�iterable_identifierrM)rKrrL)rrPr"r"r#r%9s z_DeepIterable.__repr__) r&r'r(rrrLrrKr$r%r"r"r"r#rI(s rIcCs t||�S)a1 A validator that performs deep validation of an iterable. :param member_validator: Validator 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 )rI)rLrKr"r"r#rHsc@sFeZdZee�d�Zee�d�Zedee��d�Zdd�Z dd�Z dS)�_DeepMapping)rAN)rJrAcCsJ|jdk r|�|||�x,|D]$}|�|||�|�||||�qWdS)zP We use a callable class to be able to change the ``__repr__``. N)�mapping_validator� key_validator�value_validator)rr r!r�keyr"r"r#r$]s z_DeepMapping.__call__cCsdj|j|jd�S)NzA)rUr)rrSrT)rr"r"r#r%hsz_DeepMapping.__repr__)r&r'r(rrrSrTrrRr$r%r"r"r"r#rQWs rQcCst|||�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 )rQ)rSrTrRr"r"r#rns )rN)N)N)�__doc__Z __future__rrrr6�_makerrrr � exceptionsr �__all__�objectrrr*rr>rr@rrCr rErrIrrQrr"r"r"r#�sJ -