Sindbad~EG File Manager
3
"��cP � @ s� d Z ddlZddlZddlmZ ddlmZmZ ddlm Z m
Z
m Z m Z ddl
mZ ddlmZ y
ejZW n" ek
r� eejd ��ZY nX d
d d d
ddddddddddddddd gZd d � Zd d� Zed d
� �Ze d d!d!d"�G d#d$� d$��Zd%d� Ze d d!d!d&�G d'd(� d(��ZdPd)d�Z e d d!d!d"�G d*d+� d+��Z d,d� Z e d d!d!d"�G d-d.� d.��Z d/d� Z e d d!d!d"�G d0d1� d1��Z!d2d� Z"e d d d!d"�G d3d4� d4��Z#d5d� Z$e d d!d!d"�G d6d7� d7��Z%dQd8d �Z&e d d!d!d"�G d9d:� d:��Z'dRd;d �Z(e d d!d!d&�G d<d=� d=��Z)d>d� Z*d?d� Z+d@d� Z,dAd� Z-e d d!d!d&�G dBdC� dC��Z.dDd� Z/e d d!d!d&�G dEdF� dF��Z0dGd� Z1e d d!d!d"�G dHdI� dI��Z2dJdK� Z3e d d!d!d"�G dLdM� dM��Z4de5e6fdN�dOd�Z7dS )Sz
Commonly useful validators.
� N)�contextmanager� )�get_run_validators�set_run_validators)�
_AndValidator�and_�attrib�attrs)�default_if_none)�NotCallableError� r �
deep_iterable� deep_mapping�disabled�ge� get_disabled�gt�in_� instance_of� is_callable�le�lt�
matches_re�max_len�min_len�not_�optional�provides� set_disabledc C s t | � 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
N)r )r � r �0/tmp/pip-build-_uu8ur7s/attrs/attr/validators.pyr 0 s c C s t � 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
)r r r r r r B s c c s" t d� z
dV W dt d� X dS )z�
Context manager that disables running validators within its context.
.. warning::
This context manager is not thread-safe!
.. versionadded:: 21.3.0
FNT)r r r r r r N s
FT)�repr�slots�hashc @ s" e Zd Ze� Zdd� Zdd� ZdS )�_InstanceOfValidatorc C s4 t || 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 r r �__call__d 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__v s z _InstanceOfValidator.__repr__N)�__name__�
__module__� __qualname__r r& r0 r1 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 type
: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 r | s
)r! �frozenr" c @ s( e Zd Ze� Ze� Zdd� Zdd� ZdS )�_MatchesReValidatorc C s0 | j |�s,tdj|j| jj|d�|| j|��dS )zP
We use a callable class to be able to change the ``__repr__``.
z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r% �patternr( N)�
match_func�
ValueErrorr+ r% r7 )r- r. r/ r( r r r r0 � s
z _MatchesReValidator.__call__c C s dj | jd�S )Nz.<matches_re validator for pattern {pattern!r}>)r7 )r+ r7 )r- r r r r1 � s z _MatchesReValidator.__repr__N)r2 r3 r4 r r7 r8 r0 r1 r r r r r6 � s r6 c C s� t jdt jt jf}||kr@tdjdjtdd� t|�D ������t | t
�r\|rVt d��| }n t j | |�}|t jkrz|j}n|t jkr�|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, c s s | ]}|r|j pd V qdS )�NoneN)r2 )�.0�er r r � <genexpr>� s z matches_re.<locals>.<genexpr>zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)�re� fullmatch�search�matchr9 r+ �join�sorted�setr) �Patternr* �compiler6 )�regex�flags�funcZ valid_funcsr7 r8 r r r r � s&
c @ s" e Zd Ze� Zdd� Zdd� ZdS )�_ProvidesValidatorc C s0 | j 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% � interfacer( N)rK Z
providedByr* r+ r% )r- r. r/ r( r r r r0 � s z_ProvidesValidator.__call__c C s dj | jd�S )Nz0<provides validator for interface {interface!r}>)rK )r+ rK )r- r r r r1 � s z_ProvidesValidator.__repr__N)r2 r3 r4 r rK r0 r1 r r r r rJ � s rJ 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 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.
)rJ )rK r r r r � s c @ s" e Zd Ze� Zdd� Zdd� ZdS )�_OptionalValidatorc C s |d kr d S | j |||� d S )N)� validator)r- r. r/ r( r r r r0 s z_OptionalValidator.__call__c C s dj t| j�d�S )Nz'<optional validator for {what} or None>)�what)r+ r! rM )r- r r r r1
s z_OptionalValidator.__repr__N)r2 r3 r4 r rM r0 r1 r r r r rL s rL 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) �listrL r )rM r r r r s
c @ s" e Zd Ze� Zdd� Zdd� ZdS )� _InValidatorc C sP y|| j k}W n tk
r& d}Y nX |sLtdj|j| j |d�|| j |��d S )NFz/'{name}' must be in {options!r} (got {value!r}))r% �optionsr( )rQ r* r9 r+ r% )r- r. r/ r( Z
in_optionsr r r r0 & s
z_InValidator.__call__c C s dj | jd�S )Nz(<in_ validator with options {options!r}>)rQ )r+ rQ )r- r r r r1 6 s z_InValidator.__repr__N)r2 r3 r4 r rQ r0 r1 r r r r rP " s rP 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 `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.
)rP )rQ r r r r < s c @ s e Zd Zdd� Zdd� ZdS )�_IsCallableValidatorc C s, 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}).)r% r( r' )�msgr( N)�callabler r+ r% r, )r- r. r/ r( �messager r r r0 T s z _IsCallableValidator.__call__c C s dS )Nz<is_callable validator>r )r- r r r r1 d s z _IsCallableValidator.__repr__N)r2 r3 r4 r0 r1 r r r r rR R s rR c C s t � S )ax
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 (`attrs.Attribute`) name,
and the value it got.
)rR r r r r r h s c @ s: e Zd Zee� d�Zedee� �d�Zdd� Zdd� Z dS )�
_DeepIterable)rM N)�defaultrM c C s8 | j dk r| j |||� x|D ]}| j|||� q W dS )zP
We use a callable class to be able to change the ``__repr__``.
N)�iterable_validator�member_validator)r- r. r/ r( �memberr r r r0 ~ s
z_DeepIterable.__call__c C s* | j d krdn
d| j ��}dj|| jd�S )Nr � zJ<deep_iterable validator for{iterable_identifier} iterables of {member!r}>)�iterable_identifierrZ )rX r+ rY )r- r\ r r r r1 � s
z_DeepIterable.__repr__)
r2 r3 r4 r r rY r rX r0 r1 r r r r rV w s
rV c C s t | ttf�rt| � } 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) rO �tupler rV )rY rX r r r r
� s c @ sF e Zd Zee� d�Zee� d�Zedee� �d�Zdd� Z dd� Z
dS )� _DeepMapping)rM N)rW rM c C sJ | j dk r| j |||� x,|D ]$}| j|||� | j|||| � q W dS )zP
We use a callable class to be able to change the ``__repr__``.
N)�mapping_validator�
key_validator�value_validator)r- r. r/ r( �keyr r r r0 � s
z_DeepMapping.__call__c C s dj | j| jd�S )NzA<deep_mapping validator for objects mapping {key!r} to {value!r}>)rb r( )r+ r` ra )r- r r r r1 � s z_DeepMapping.__repr__) r2 r3 r4 r r r` ra r r_ r0 r1 r r r r r^ � s
r^ 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
)r^ )r` ra r_ r r r r � s
c @ s. e Zd Ze� Ze� Ze� Zdd� Zdd� ZdS )�_NumberValidatorc C s. | j || j�s*tdj|j| j| j|d���dS )zP
We use a callable class to be able to change the ``__repr__``.
z&'{name}' must be {op} {bound}: {value})r% �op�boundr( N)� compare_funcre r9 r+ r% �
compare_op)r- r. r/ r( r r r r0 � s z_NumberValidator.__call__c C s dj | j| jd�S )Nz <Validator for x {op} {bound}>)rd re )r+ rg re )r- r r r r1 � s z_NumberValidator.__repr__N) r2 r3 r4 r re rg rf r0 r1 r r r r rc � s
rc c C s t | dtj�S )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
�<)rc �operatorr )�valr r r r � s c C s t | dtj�S )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<=)rc ri r )rj r r r r � s c C s t | dtj�S )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>=)rc ri r )rj r r r r s c C s t | dtj�S )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
�>)rc ri r )rj r r r r
s c @ s" e Zd Ze� Zdd� Zdd� ZdS )�_MaxLengthValidatorc C s. t |�| jkr*tdj|j| jt |�d���dS )zP
We use a callable class to be able to change the ``__repr__``.
z*Length of '{name}' must be <= {max}: {len})r% �max�lenN)rn �
max_lengthr9 r+ r% )r- r. r/ r( r r r r0 s z _MaxLengthValidator.__call__c C s d| j � d�S )Nz<max_len validator for rk )ro )r- r r r r1 ( s z _MaxLengthValidator.__repr__N)r2 r3 r4 r ro r0 r1 r r r r rl s rl c C s t | �S )z�
A validator that raises `ValueError` if the initializer is called
with a string or iterable that is longer than *length*.
:param int length: Maximum length of the string or iterable
.. versionadded:: 21.3.0
)rl )�lengthr r r r , s c @ s" e Zd Ze� Zdd� Zdd� ZdS )�_MinLengthValidatorc C s. t |�| jk r*tdj|j| jt |�d���dS )zP
We use a callable class to be able to change the ``__repr__``.
z*Length of '{name}' must be => {min}: {len})r% �minrn N)rn �
min_lengthr9 r+ r% )r- r. r/ r( r r r r0 < s z _MinLengthValidator.__call__c C s d| j � d�S )Nz<min_len validator for rk )rs )r- r r r r1 G s z _MinLengthValidator.__repr__N)r2 r3 r4 r rs r0 r1 r r r r rq 8 s rq c C s t | �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
)rq )rp r r r r K s c @ s" e Zd Ze� Zdd� Zdd� ZdS )�_SubclassOfValidatorc C s0 t || j�s,tdj|j| j|d�|| j|��dS )zP
We use a callable class to be able to change the ``__repr__``.
z8'{name}' must be a subclass of {type!r} (got {value!r}).)r% r& r( N)�
issubclassr& r* r+ r% )r- r. r/ r( r r r r0 [ s z _SubclassOfValidator.__call__c C s dj | jd�S )Nz)<subclass_of validator for type {type!r}>)r& )r+ r& )r- r r r r1 l s z _SubclassOfValidator.__repr__N)r2 r3 r4 r r& r0 r1 r r r r rt W s rt 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
`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.
)rt )r& r r r � _subclass_ofr s
rv c @ sJ e Zd Ze� Zeed�d�Zeeee �e
e �d�d�Z dd� Z
dd� Zd S )
�
_NotValidatorzCnot_ validator child '{validator!r}' did not raise a captured error)� converter)rY rX )rM c C sR y| j |||� W n | jk
r( Y n&X t| jj| j | jd�|| j || j��d S )N)rM � exc_types)rM ry r9 rS r+ )r- r. r/ r( r r r r0 � s z_NotValidator.__call__c C s dj | j| jd�S )Nz;<not_ validator wrapping {what!r}, capturing {exc_types!r}>)rN ry )r+ rM ry )r- r r r r1 � s z_NotValidator.__repr__N)r2 r3 r4 r rM r
rS r
rv � Exceptionr r] ry r0 r1 r r r r rw � s
rw )rS ry c C s4 y t |�}W n tk
r& |f}Y nX t| ||�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* rw )rM rS ry r r r r � s
)r N)N)N)8�__doc__ri r> �
contextlibr Z_configr r �_maker r r r �
convertersr
�
exceptionsr rE �AttributeErrorr& rF �__all__r r r r$ r r6 r rJ r rL r rP r rR r rV r
r^ r rc r r r r rl r rq r rt rv rw r9 r* r r r r r �<module> s|
0
*
Sindbad File Manager Version 1.0, Coded By Sindbad EG ~ The Terrorists