| Server IP : 138.197.176.125 / Your IP : 216.73.217.54 Web Server : Apache/2.4.41 (Ubuntu) System : Linux SuiteCRM-8 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64 User : root ( 0) PHP Version : 8.3.19 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /lib/python3/dist-packages/attr/__pycache__/ |
Upload File : |
U
]�]�, � @ s� d Z ddlmZmZmZ ddlZddlmZmZm Z m
Z
ddl m Z ddd d
d d d
ddg Z
e
dddd�G dd� de��Zdd � Ze
ddd�G dd� de��Zd,dd
�Ze
dddd�G dd� de��Zd d� Ze
dddd�G d d � d e��Zd d� Ze
dddd�G d d!� d!e��Zd"d
� Ze
dddd�G d#d$� d$e��Zd%d � Ze
dddd�G d&d'� d'e��Zd-d(d�Z e
dddd�G d)d*� d*e��Z d.d+d �Z dS )/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" 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$ �1/usr/lib/python3/dist-packages/attr/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__0 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 `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 r' r$ r$ r% r 6 s
)r �frozenc @ s. e Zd Ze� Ze� Ze� Zdd� Zdd� ZdS )�_MatchesReValidatorc C s0 | � |�s,tdj|j| jj|d�|| j|��dS )r z7'{name}' must match regex {regex!r} ({value!r} doesn't))r �regexr N)�
match_func�
ValueErrorr r r/ �patternr r$ r$ r% r& L s
��z _MatchesReValidator.__call__c C s dj | jd�S )Nz,<matches_re validator for pattern {regex!r}>)r/ )r r/ r( r$ r$ r% r) [ s �z _MatchesReValidator.__repr__N) r* r+ r, r r/ �flagsr0 r& r) r$ r$ r$ r% r. F s
r. c C s� t tdd�}|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, c s s | ]}|r|j pd V qdS )�NoneN)r* )�.0�er$ r$ r% � <genexpr>x s z matches_re.<locals>.<genexpr>z(?:{})\Z) �getattr�re�search�matchr1 �join�sorted�set�compiler4 r r. )r/ r3 �funcr4 Z valid_funcsr2 r0 r$ r$ r% r a 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)rC 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}>�rC )r rC r( r$ r$ r% r) � s �z_ProvidesValidator.__repr__N)r* r+ r, r rC r& r) r$ r$ r$ r% rB � s rB c C s t | �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
<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 `attr.Attribute`), the expected interface, and the
value it got.
)rB rD 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& � s z_OptionalValidator.__call__c C s dj t| j�d�S )Nz'<optional validator for {what} or None>)Zwhat)r r rG r( r$ r$ r% r) � s �z_OptionalValidator.__repr__N)r* r+ r, r rG r& r) r$ r$ r$ r% rE � s rE 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 `list` of callables.
.. versionadded:: 15.1.0
.. versionchanged:: 17.1.0 *validator* can be a list of validators.
)r �listrE r rF r$ r$ r% r � s
c @ s" e Zd Ze� Zdd� Zdd� ZdS )� _InValidatorc C sH z|| j k}W n tk
r& d}Y nX |sDtdj|j| j |d���d S )NFz/'{name}' must be in {options!r} (got {value!r}))r �optionsr )rJ r r1 r r )r! r" r# r Z
in_optionsr$ r$ r% r& � s
��z_InValidator.__call__c C s dj | jd�S )Nz(<in_ validator with options {options!r}>�rJ )r rJ r( r$ r$ r% r) � s �z_InValidator.__repr__N)r* r+ r, r rJ r& r) r$ r$ r$ r% rI � s
rI c C s t | �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
)rI rK r$ r$ r% r
� s c @ s e Zd Zdd� Zdd� ZdS )�_IsCallableValidatorc C s, t |�s(d}t|j|j||jd�|d��dS )r z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r r r )�msgr N)�callabler
r r r )r! r" r# r �messager$ r$ r% r& s � ��z _IsCallableValidator.__call__c C s dS )Nz<is_callable validator>r$ r( r$ r$ r% r) s z _IsCallableValidator.__repr__N)r* r+ r, r& r) r$ r$ r$ r% rL s rL c C s t � 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.
)rL r$ r$ r$ r% r s c @ s: e Zd Zee� d�Zedee� �d�Zdd� Zdd� Z dS )�
_DeepIterablerF N��defaultrG c C s4 | j dk r| � |||� |D ]}| �|||� q dS �r N)�iterable_validator�member_validator)r! r" r# r �memberr$ r$ r% r& . s
z_DeepIterable.__call__c C s, | j d krdn dj| j d�}dj|| jd�S )N� z
{iterable!r})�iterablezJ<deep_iterable validator for{iterable_identifier} iterables of {member!r}>)�iterable_identifierrV )rT r rU )r! rY r$ r$ r% r) 8 s � ���z_DeepIterable.__repr__)
r* r+ r, r r rU r rT r& r) r$ r$ r$ r% rP ' s �
rP c C s
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
)rP )rU rT r$ r$ r% r G s c @ sF e Zd Zee� d�Zee� d�Zedee� �d�Zdd� Z dd� Z
dS )� _DeepMappingrF NrQ c C sF | j dk r| � |||� |D ]$}| �|||� | �|||| � q dS rS )�mapping_validator�
key_validator�value_validator)r! r" r# r �keyr$ r$ r% r& \ s
z_DeepMapping.__call__c C s dj | j| jd�S )NzA<deep_mapping validator for objects mapping {key!r} to {value!r}>)r^ r )r r\ r] r( r$ r$ r% r) g s
� �z_DeepMapping.__repr__) r* r+ r, r r r\ r] r r[ r& r) r$ r$ r$ r% rZ V s
rZ c C s 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
)rZ )r\ r] r[ r$ r$ r% r m s
)r N)N)N) �__doc__Z
__future__r r r r: �_maker r r r �
exceptionsr
�__all__�objectr r r. r rB r rE r rI r
rL r rP r rZ r r$ r$ r$ r% �<module> sL �
-