o
�J�hNN � @ s� d Z ddlZddlZddlmZ ddlmZ ddlmZmZ ddl m
Z
m Z m Z m
Z
ddlmZ dd lmZ g d
�Zd d � Zd
d� Zedd� �Ze
dddd�G dd� d��Zdd� Ze
dddd�G dd� d��ZdPdd �Ze
dddd�G d d � d ��Zd d � Ze
dddd�G d!d"� d"��Z d#d$� Z e
dddd�G d%d&� d&��Z d'd(� Z e
dddd�G d)d*� d*��Z dQd+d,�Z!e
dddd�G d-d.� d.��Z"dQd/d0�Z#e
dddd�G d1d2� d2��Z$d3d4� Z%d5d6� Z&d7d8� Z'd9d:� Z(e
dddd�G d;d<� d<��Z)d=d>� Z*e
dddd�G d?d@� d@��Z+dAdB� Z,e
dddd�G dCdD� dD��Z-dEdF� Z.e
dddd�G dGdH� dH��Z/de0e1fdI�dJdK�Z2e
dddd�G dLdM� dM��Z3dNdO� Z4dS )Rz
Commonly useful validators.
� N)�contextmanager)�Pattern� )�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�or_� set_disabledc C s t | � 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
N�r )r � r �MC:\pinokio\api\whisper-webui.git\app\env\lib\site-packages\attr\validators.pyr * s r c C s t � 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
)r r r r r! r < s r c c s* � t d� z
dV W t d� dS t d� w )z�
Context manager that disables running validators within its context.
.. warning::
This context manager is not thread-safe!
.. versionadded:: 21.3.0
FNTr r r r r! r H s
� r FT)�repr�slots� unsafe_hashc @ �" e Zd Ze� Zdd� Zdd� ZdS )�_InstanceOfValidatorc C sD t || j�s d|j� d| j�d|�d|j�d� }t||| j|��dS )�P
We use a callable class to be able to change the ``__repr__``.
�'�
' must be � (got z that is a �).N)�
isinstance�type�name� __class__� TypeError��self�inst�attr�value�msgr r r! �__call__^ s $��z _InstanceOfValidator.__call__c C � d| j �d�S )Nz <instance_of validator for type �>�r- �r2 r r r! �__repr__k � z _InstanceOfValidator.__repr__N��__name__�
__module__� __qualname__r r- r7 r< r r r r! r& Z �
r& c C � 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).
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! r o � r )r" �frozenr# c @ s( e Zd Ze� Ze� Zdd� Zdd� ZdS )�_MatchesReValidatorc C s< | � |�s d|j� d| jj�d|�d�}t||| j|��dS )r' r( z' must match regex z (z doesn't)N)�
match_funcr. �pattern�
ValueErrorr1 r r r! r7 � s
��z _MatchesReValidator.__call__c C r8 )Nz"<matches_re validator for pattern r9 )rH r; r r r! r< � r= z _MatchesReValidator.__repr__N)r? r@ rA r rH rG r7 r< r r r r! rF � s
rF c C s� t jdt jt jf}||vr"d�d�tdd� t|�D ����}t|��t | t
�r2|r/d}t |��| }nt � | |�}|t ju rA|j}n |t ju rJ|j}n|j}t
||�S )a�
A validator that raises `ValueError` if the initializer is called with a
string that doesn't match *regex*.
Args:
regex (str, re.Pattern):
A regex string or precompiled pattern to match against
flags (int):
Flags that will be passed to the underlying re function (default 0)
func (typing.Callable):
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 p
d V qdS )�NoneN)r? )�.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�match�format�join�sorted�setrI r, r r0 �compilerF )�regex�flags�funcZ valid_funcsr6 rH rG r r r! r � s( ��
r c @ r% )�_OptionalValidatorc C s |d u rd S | � |||� d S �N�� validator�r2 r3 r4 r5 r r r! r7 � s z_OptionalValidator.__call__c C r8 )Nz<optional validator for z or None>r\ r; r r r! r< � r= z_OptionalValidator.__repr__N)r? r@ rA r r] r7 r< r r r r! rZ � s rZ c C s" t | ttf�r
tt| ��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.
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, �list�tuplerZ r r\ r r r! r � s r c @ s, e Zd Ze� Zedd�Zdd� Zdd� ZdS )� _InValidatorF)�hashc C sZ z|| j v }W n ty d}Y nw |s+d|j� d| j�d|�d�}t||| j|��d S )NFr( z
' must be in r* �))�optionsr0 r. �_original_optionsrI )r2 r3 r4 r5 Z
in_optionsr6 r r r! r7 � s � ��z_InValidator.__call__c C r8 )Nz <in_ validator with options r9 )re r; r r r! r< � r= z_InValidator.__repr__N)r? r@ rA r rd re r7 r< r r r r! ra � s
ra c C s& | }t | tttf�rt| �} 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``, so *options* has to
support that operation.
To keep the validator hashable, dicts, lists, and sets are transparently
transformed into a `tuple`.
Args:
options: Allowed options.
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.
.. versionchanged:: 24.1.0
*options* that are a list, dict, or a set are now transformed into a
tuple to keep the validator hashable.
)r, r_ �dictrU r` ra )rd Z repr_optionsr r r! r s
r c @ s e Zd Zdd� Zdd� ZdS )�_IsCallableValidatorc C s, t |�sd}t|j|j||jd�|d��dS )r' z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r. r5 �actual)r6 r5 N)�callabler rR r. r/ )r2 r3 r4 r5 �messager r r! r7 & s �
���z _IsCallableValidator.__call__c C s dS )Nz<is_callable validator>r r; r r r! r< 6 s z _IsCallableValidator.__repr__N)r? r@ rA r7 r< r r r r! rg $ s rg c C s t � S )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.
)rg r r r r! r : s
r c @ s: e Zd Zee� d�Zedee� �d�Zdd� Zdd� Z dS )�
_DeepIterabler\ N��defaultr] c C s4 | j dur | � |||� |D ] }| �|||� qdS �r' N��iterable_validator�member_validator)r2 r3 r4 r5 �memberr r r! r7 Q s
�z_DeepIterable.__call__c C s. | j d u rdnd| j ��}d|� d| j�d�S )N� � z <deep_iterable validator forz iterables of r9 ro )r2 Ziterable_identifierr r r! r< [ s
�
���z_DeepIterable.__repr__)
r? r@ rA r r rq r rp r7 r< r r r r! rk J s
�
rk c C s t | ttf�r t| � } t| |�S )aC
A validator that performs deep validation of an iterable.
Args:
member_validator: Validator to apply to iterable members.
iterable_validator:
Validator to apply to iterable itself (optional).
Raises
TypeError: if any sub-validators fail
.. versionadded:: 19.1.0
)r, r_ r` r rk �rq rp r r r! r
g s
r
c @ sF e Zd Zee� d�Zee� d�Zedee� �d�Zdd� Z dd� Z
dS )� _DeepMappingr\ Nrl c C sF | j dur | � |||� |D ]}| �|||� | �|||| � qdS rn )�mapping_validator�
key_validator�value_validator)r2 r3 r4 r5 �keyr r r! r7 � s
�z_DeepMapping.__call__c C � d| j �d| j�d�S )Nz,<deep_mapping validator for objects mapping z to r9 )rx ry r; r r r! r< � � z_DeepMapping.__repr__) r? r@ rA r r rx ry r rw r7 r< r r r r! rv { s rv c C s t | ||�S )a�
A validator that performs deep validation of a dictionary.
Args:
key_validator: Validator to apply to dictionary keys.
value_validator: Validator to apply to dictionary values.
mapping_validator:
Validator to apply to top-level mapping attribute (optional).
.. versionadded:: 19.1.0
Raises:
TypeError: if any sub-validators fail
)rv )rx ry rw r r r! r � s r c @ s. e Zd Ze� Ze� Ze� Zdd� Zdd� ZdS )�_NumberValidatorc C s< | � || j�s d|j� d| j� d| j� d|� �}t|��dS )r' r( r) rt �: N)� compare_func�boundr. �
compare_oprI r1 r r r! r7 � s "�z_NumberValidator.__call__c C s d| j � d| j� d�S )Nz<Validator for x rt r9 )r� r� r; r r r! r< � r| z_NumberValidator.__repr__N) r? r@ rA r r� r� r r7 r< r r r r! r} � s r} c C � t | dtj�S )a
A validator that raises `ValueError` if the initializer is called with a
number larger or equal to *val*.
The validator uses `operator.lt` to compare the values.
Args:
val: Exclusive upper bound for values.
.. versionadded:: 21.3.0
�<)r} �operatorr ��valr r r! r � � r c C r� )a
A validator that raises `ValueError` if the initializer is called with a
number greater than *val*.
The validator uses `operator.le` to compare the values.
Args:
val: Inclusive upper bound for values.
.. versionadded:: 21.3.0
z<=)r} r� r r� r r r! r � r� r c C r� )a
A validator that raises `ValueError` if the initializer is called with a
number smaller than *val*.
The validator uses `operator.ge` to compare the values.
Args:
val: Inclusive lower bound for values
.. versionadded:: 21.3.0
z>=)r} r� r r� r r r! r � r� r c C r� )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 )r} r� r r� r r r! r � r� r c @ r% )�_MaxLengthValidatorc C s8 t |�| jkrd|j� d| j� dt |�� �}t|��dS )r' � Length of 'z
' must be <= r~ N)�len�
max_lengthr. rI r1 r r r! r7 � � �z _MaxLengthValidator.__call__c C � d| j � d�S )Nz<max_len validator for r9 )r� r; r r r! r< � r= z _MaxLengthValidator.__repr__N)r? r@ rA r r� r7 r< r r r r! r� � � r� c C rC )z�
A validator that raises `ValueError` if the initializer is called
with a string or iterable that is longer than *length*.
Args:
length (int): Maximum length of the string or iterable
.. versionadded:: 21.3.0
)r� ��lengthr r r! r �
r c @ r% )�_MinLengthValidatorc C s8 t |�| jk rd|j� d| j� dt |�� �}t|��dS )r' r� z
' must be >= r~ N)r� �
min_lengthr. rI r1 r r r! r7 r� z _MinLengthValidator.__call__c C r� )Nz<min_len validator for r9 )r� r; r r r! r< r= z _MinLengthValidator.__repr__N)r? r@ rA r r� r7 r< r r r r! r� r� r� c C rC )z�
A validator that raises `ValueError` if the initializer is called
with a string or iterable that is shorter than *length*.
Args:
length (int): Minimum length of the string or iterable
.. versionadded:: 22.1.0
)r� r� r r r! r r� r c @ r% )�_SubclassOfValidatorc C s< t || j�s d|j� d| j�d|�d�}t||| j|��dS )r' r( z' must be a subclass of r* r+ N)�
issubclassr- r. r0 r1 r r r! r7 0 s ��z _SubclassOfValidator.__call__c C r8 )Nz <subclass_of validator for type r9 r: r; r r r! r< = r= z _SubclassOfValidator.__repr__Nr> r r r r! r� , rB r� c C rC )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.
)r� r: r r r! � _subclass_ofA rD r� 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)� converterru r\ c C sN z | � |||� W n | jy Y d S w t| jj| j | jd�|| j || j��)N�r] � exc_types)r] r� rI r6 rR r^ r r r! r7 b s ���z_NotValidator.__call__c C r{ )Nz<not_ validator wrapping z , capturing r9 r� r; r r r! r< s r| z_NotValidator.__repr__N)r? r@ rA r r] r r6 r
r� � Exceptionr r` r� r7 r< r r r r! r� R s ���� r� )r6 r� c C s2 zt |�}W n ty |f}Y nw 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_(...))``.
Args:
validator: A validator to be logically inverted.
msg (str):
Message to raise if validator fails. Formatted with keys
``exc_types`` and ``validator``.
exc_types (tuple[type, ...]):
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` r0 r� )r] r6 r� r r r! r w s
� r c @ r% )� _OrValidatorc C sL | j D ]}z
||||� W d S ty Y qw d| j �d|��}t|��)NzNone of z satisfied for value )�
validatorsr� rI )r2 r3 r4 r5 �vr6 r r r! r7 � s
��z_OrValidator.__call__c C r8 )Nz<or validator wrapping r9 )r� r; r r r! r< � r= z_OrValidator.__repr__N)r? r@ rA r r� r7 r< r r r r! r� � s r� c G s6 g }| D ]}|� t|t�r|jn|g� qtt|��S )a
A validator that composes multiple validators into one.
When called on a value, it runs all wrapped validators until one of them is
satisfied.
Args:
validators (~collections.abc.Iterable[typing.Callable]):
Arbitrary number of validators.
Raises:
ValueError:
If no validator is satisfied. Raised with a human-readable error
message listing all the wrapped validators and the value that
failed all of them.
.. versionadded:: 24.1.0
)�extendr, r� r� r` )r� �valsr� r r r! r � s r )r Nr[ )5�__doc__r� rN �
contextlibr r �_configr r �_maker r r r
�
convertersr �
exceptionsr �__all__r r r r& r rF r rZ r ra r rg r rk r
rv r r} r r r r r� r r� r r� r� r� rI r0 r r� r r r r r! �<module> sp
0
#
$ $