U
#IGZ` � @ s� d Z ddlmZmZmZ ddlmZmZmZm Z ddddd gZ
e d
d d d �G d
d� de ��Z dd� Z
e d
d d d �G dd� de ��Zdd � Ze d
d d d �G dd� de ��Zdd� Ze d
d d d �G dd� de ��Zdd� ZdS )z
Commonly useful validators.
� )�absolute_import�division�print_function� )�
_AndValidator�and_�attrib�attrsr �in_� instance_of�optional�providesFT)�repr�slots�hashc @ s" e Zd Ze� Zdd� Zdd� ZdS )�_InstanceOfValidatorc C s4 t || j�s0tdj|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}).)�name�type�actual�valueN)�
isinstancer � TypeError�formatr � __class__��self�inst�attrr � r �/validators.py�__call__ s � �z _InstanceOfValidator.__call__c C s dj | jd�S )Nz)<instance_of validator for type {type!r}>�r )r r �r r r r �__repr__$ s ��z _InstanceOfValidator.__repr__N)�__name__�
__module__� __qualname__r r r! r$ r r r r r s
r c C s t | �S )a�
A validator that raises a :exc:`TypeError` if the initializer is called
with a wrong type for this particular attribute (checks are performed using
:func:`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 :class:`attr.Attribute`), the expected type, and the value it
got.
)r r" r r r r + s
c @ s" e Zd Ze� Zdd� Zdd� ZdS )�_ProvidesValidatorc C s0 | j �|�s,tdj|j| j |d�|| j |��dS )r z<'{name}' must provide {interface!r} which {value!r} doesn't.)r � interfacer N)r) Z
providedByr r r r r r r r! ? s � �z_ProvidesValidator.__call__c C s dj | jd�S )Nz0<provides validator for interface {interface!r}>�r) )r r) r# r r r r$ K s ��z_ProvidesValidator.__repr__N)r% r& r' r r) r! r$ r r r r r( ; s r( c C s t | �S )a
A validator that raises a :exc:`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
<https://zopeinterface.readthedocs.io/en/latest/>`_).
:param zope.interface.Interface interface: The interface to check for.
:raises TypeError: With a human readable error message, the attribute
(of type :class:`attr.Attribute`), the expected interface, and the
value it got.
)r( r* r r r r
R s
c @ s" e Zd Ze� Zdd� Zdd� ZdS )�_OptionalValidatorc C s |d kr d S | � |||� d S )N�� validatorr r r r r! f s z_OptionalValidator.__call__c C s dj t| j�d�S )Nz'<optional validator for {what} or None>)Zwhat)r r r- r# r r r r$ l s ��z_OptionalValidator.__repr__N)r% r& r' r r- r! r$ r r r r r+ b s r+ c C s t | t�rtt| ��S t| �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 :class:`list` of callables.
.. versionadded:: 15.1.0
.. versionchanged:: 17.1.0 *validator* can be a list of validators.
)r �listr+ r r, r r r r s s
c @ s" e Zd Ze� Zdd� Zdd� ZdS )� _InValidatorc C s& || j kr"tdj|j| j |d���d S )Nz/'{name}' must be in {options!r} (got {value!r}))r �optionsr )r0 �
ValueErrorr r r r r r r! � s
��z_InValidator.__call__c C s dj | jd�S )Nz(<in_ validator with options {options!r}>�r0 )r r0 r# r r r r$ � s ��z_InValidator.__repr__N)r% r& r' r r0 r! r$ r r r r r/ � s r/ c C s t | �S )a�
A validator that raises a :exc:`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, :class:`enum.Enum`, ...
:raises ValueError: With a human readable error message, the attribute (of
type :class:`attr.Attribute`), the expected options, and the value it
got.
.. versionadded:: 17.1.0
)r/ r2 r r r r
� s N)�__doc__Z
__future__r r r �_maker r r r �__all__�objectr r r( r
r+ r r/ r
r r r r �<module> s( �