Your IP : 18.116.19.29


Current Path : /opt/imunify360/venv/lib64/python3.11/site-packages/attr/__pycache__/
Upload File :
Current File : //opt/imunify360/venv/lib64/python3.11/site-packages/attr/__pycache__/validators.cpython-311.pyc

�

Q�Dg�P��h�dZddlZddlZddlmZddlmZddlmZmZddl	m
Z
mZmZm
Z
ddlmZdd	lmZgd
�Zd�Zd�Zed
���Ze
ddd���Gd�d����Zd�Ze
ddd���Gd�d����Zd=d�Ze
ddd���Gd�d����Zd�Ze
ddd���Gd�d����Zd�Ze
ddd���Gd�d����Zd �Ze
ddd���Gd!�d"����Z d#�Z!e
ddd���Gd$�d%����Z"d>d&�Z#e
ddd���Gd'�d(����Z$d>d)�Z%e
ddd���Gd*�d+����Z&d,�Z'd-�Z(d.�Z)d/�Z*e
ddd���Gd0�d1����Z+d2�Z,e
ddd���Gd3�d4����Z-d5�Z.e
ddd���Gd6�d7����Z/d8�Z0e
ddd���Gd9�d:����Z1de2e3fd;�d<�Z4dS)?z
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�provides�set_disabledc�&�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)rs �o/builddir/build/BUILD/imunify360-venv-2.4.0/opt/imunify360/venv/lib/python3.11/site-packages/attr/validators.pyrr+s���8�|�$�$�$�$�$�c� �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"rr=s��"�#�#�#�#r#c#�xK�td��	dV�td��dS#td��wxYw)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"rrIsM�����u����!�
�����4� � � � � ���4� � � � ���s�(�9FT)�repr�slots�hashc�.�eZdZe��Zd�Zd�ZdS)�_InstanceOfValidatorc��t||j��s=td�|j|j|j|���||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�attrr1s    r"�__call__z_InstanceOfValidator.__call___sl���%���+�+�	���%�v����� �?��	 &� � ���	����
�	�	r#c�8�d�|j���S)Nz)<instance_of validator for type {type!r}>�r/�r4r/�r7s r"�__repr__z_InstanceOfValidator.__repr__q�%��:�A�A���B�
�
�	
r#N��__name__�
__module__�__qualname__r
r/r:r?r%r#r"r+r+[s=�������6�8�8�D����$
�
�
�
�
r#r+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).

    :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<s r"rrw��� ��%�%�%r#)r'�frozenr(c�B�eZdZe��Ze��Zd�Zd�ZdS)�_MatchesReValidatorc��|�|��s<td�|j|jj|���||j|���dS)r-z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r.�patternr1N)�
match_func�
ValueErrorr4r.rKr6s    r"r:z_MatchesReValidator.__call__�sh�����u�%�%�		��'�'-�v���D�L�,@��(.�(�(�������
�		�		r#c�8�d�|j���S)Nz.<matches_re validator for pattern {pattern!r}>)rK)r4rKr>s r"r?z_MatchesReValidator.__repr__�s%��?�F�F��L�G�
�
�	
r#N)rBrCrDr
rKrLr:r?r%r#r"rIrI�sH�������f�h�h�G�����J�
�
�
�
�
�
�
�
r#rIc��tjdtjtjf}||vrYt	d�d�td�t|��D�����������t|t��r|rtd���|}ntj||��}|tjur|j}n|tjur|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, c3�,K�|]}|r|jpdV��dS)�NoneN)rB)�.0�es  r"�	<genexpr>zmatches_re.<locals>.<genexpr>�s?������78��(�a�j�2�F������r#zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)�re�	fullmatch�search�matchrMr4�join�sorted�setr2rr3�compilerI)�regex�flags�func�valid_funcsrKrLs      r"rr�s�� �<��r�y�"�(�;�K��;����'�.�.��	�	����<?��<L�<L��������
�
�
�
�	
��%��!�!�+��	��5���
�����*�U�E�*�*���r�x����]�
�
�	
���	�	��^�
�
��&�
��w�
�3�3�3r#c�.�eZdZe��Zd�Zd�ZdS)�_ProvidesValidatorc��|j�|��s7td�|j|j|���||j|���dS)r-z<'{name}' must provide {interface!r} which {value!r} doesn't.)r.�	interfacer1N)rd�
providedByr3r4r.r6s    r"r:z_ProvidesValidator.__call__�si���~�(�(��/�/�		���!�6���d�n�E�"���������
�		�		r#c�8�d�|j���S)Nz0<provides validator for interface {interface!r}>)rd)r4rdr>s r"r?z_ProvidesValidator.__repr__�s%��A�H�H��n�I�
�
�	
r#N)rBrCrDr
rdr:r?r%r#r"rbrb�s=����������I�
�
�
�
�
�
�
�
r#rbc�b�ddl}|�dtd���t|��S)aE
    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.

    .. deprecated:: 23.1.0
    rNzZattrs's zope-interface support is deprecated and will be removed in, or after, April 2024.�)�
stacklevel)�warnings�warn�DeprecationWarningrb)rdrjs  r"rr�sC�� �O�O�O��M�M�	 ���	�����i�(�(�(r#c�.�eZdZe��Zd�Zd�ZdS)�_OptionalValidatorc�<�|�dS|�|||��dS�N��	validatorr6s    r"r:z_OptionalValidator.__call__	s(���=��F����t�T�5�)�)�)�)�)r#c�R�d�t|j�����S)Nz'<optional validator for {what} or None>)�what)r4r'rrr>s r"r?z_OptionalValidator.__repr__s-��8�?�?��d�n�%�%�@�
�
�	
r#N)rBrCrDr
rrr:r?r%r#r"rnrns=����������I�*�*�*�
�
�
�
�
r#rnc��t|ttf��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 Callable | tuple[Callable] | list[Callable] validator: 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.
    )r2�list�tuplernrrqs r"rrs>���)�d�E�]�+�+�<�!�-�	�":�":�;�;�;��i�(�(�(r#c�.�eZdZe��Zd�Zd�ZdS)�_InValidatorc��	||jv}n#t$rd}YnwxYw|s7td�|j|j|���||j|���dS)NFz/'{name}' must be in {options!r} (got {value!r}))r.�optionsr1)r{r3rMr4r.)r7r8r9r1�
in_optionss     r"r:z_InValidator.__call__,s���	��$�,�.�J�J���	�	�	��J�J�J�	�����	��A�H�H���D�L��I�������
��
�	�	s�	��c�8�d�|j���S)Nz(<in_ validator with options {options!r}>�r{)r4r{r>s r"r?z_InValidator.__repr__<s%��9�@�@��L�A�
�
�	
r#N)rBrCrDr
r{r:r?r%r#r"ryry(s=�������f�h�h�G���� 
�
�
�
�
r#ryc� �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.
    )ryr~s r"rrBs��&�� � � r#c��eZdZd�Zd�ZdS)�_IsCallableValidatorc��t|��s3d}t|�|j||j���|����dS)r-z?'{name}' must be callable (got {value!r} that is a {actual!r}).)r.r1r0)�msgr1N)�callabler
r4r.r5)r7r8r9r1�messages     r"r:z_IsCallableValidator.__call__Zse������
	�8�
�#��N�N���%���#����	���
�
	�
	r#c��dS)Nz<is_callable validator>r%r>s r"r?z_IsCallableValidator.__repr__js��(�(r#N)rBrCrDr:r?r%r#r"r�r�Xs2��������� )�)�)�)�)r#r�c��t��S)ax
    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.
    )r�r%r#r"rrns�� �!�!�!r#c�~�eZdZee�����Zedee�������Zd�Zd�Z	dS)�
_DeepIterablerqN��defaultrrc�z�|j�|�|||��|D]}|�|||���dS�r-N)�iterable_validator�member_validator)r7r8r9r1�members     r"r:z_DeepIterable.__call__�sY���"�.��#�#�D�$��6�6�6��	6�	6�F��!�!�$��f�5�5�5�5�	6�	6r#c�`�|j�dn	d|j��}d�||j���S)N�� zJ<deep_iterable validator for{iterable_identifier} iterables of {member!r}>)�iterable_identifierr�)r�r4r�)r7r�s  r"r?z_DeepIterable.__repr__�sN���&�.�
�B�0�T�,�0�0�	�
(�
�&� 3��(��
�
�	
r#)
rBrCrDr
rr�rr�r:r?r%r#r"r�r�}sw�������v���
�
�6�6�6����������� 7� 7�����6�6�6�
�
�
�
�
r#r�c�l�t|ttf��r	t|�}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
    )r2rvrwr	r��r�r�s  r"rr�s9���"�T�5�M�2�2�3��!1�2���)�+=�>�>�>r#c��eZdZee�����Zee�����Zedee�������Zd�Z	d�Z
dS)�_DeepMappingrqNr�c��|j�|�|||��|D]6}|�|||��|�||||���7dSr�)�mapping_validator�
key_validator�value_validator)r7r8r9r1�keys     r"r:z_DeepMapping.__call__�su���!�-��"�"�4��u�5�5�5��	9�	9�C����t�T�3�/�/�/�� � ��t�U�3�Z�8�8�8�8�	9�	9r#c�D�d�|j|j���S)NzA<deep_mapping validator for objects mapping {key!r} to {value!r}>)r�r1)r4r�r�r>s r"r?z_DeepMapping.__repr__�s"��O�
�&�T�'�t�/C�&�
D�
D�	Er#)rBrCrDr
rr�r�rr�r:r?r%r#r"r�r��s��������F�[�[�]�]�3�3�3�M��f�{�{�}�}�5�5�5�O���t�x�x���
�
�7N�7N�O�O�O��	9�	9�	9�E�E�E�E�Er#r�c�$�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�r�r�s   r"rr�s���
��8I�J�J�Jr#c�V�eZdZe��Ze��Ze��Zd�Zd�ZdS)�_NumberValidatorc��|�||j��s5td�|j|j|j|������dS)r-z&'{name}' must be {op} {bound}: {value})r.�op�boundr1N)�compare_funcr�rMr4r.�
compare_opr6s    r"r:z_NumberValidator.__call__�se��� � ���
�3�3�	��8�?�?������*��	@�����
�	�	r#c�D�d�|j|j���S)Nz<Validator for x {op} {bound}>)r�r�)r4r�r�r>s r"r?z_NumberValidator.__repr__�s(��/�6�6���d�j�7�
�
�	
r#N)	rBrCrDr
r�r�r�r:r?r%r#r"r�r��sS�������F�H�H�E�����J��6�8�8�L����
�
�
�
�
r#r�c�8�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
    �<)r��operatorr��vals r"rr�����C��h�k�2�2�2r#c�8�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<=)r�r�rr�s r"rr�����C��x�{�3�3�3r#c�8�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>=)r�r�rr�s r"rrr�r#c�8�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
    �>)r�r�rr�s r"rrr�r#c�.�eZdZe��Zd�Zd�ZdS)�_MaxLengthValidatorc	��t|��|jkr<td�|j|jt|��������dS)r-z*Length of '{name}' must be <= {max}: {len})r.�max�lenN)r��
max_lengthrMr4r.r6s    r"r:z_MaxLengthValidator.__call__#�[���u�:�:���'�'��<�C�C�����S��Z�Z�D�����
�(�'r#c��d|j�d�S)Nz<max_len validator for r�)r�r>s r"r?z_MaxLengthValidator.__repr__.���;���;�;�;�;r#N)rBrCrDr
r�r:r?r%r#r"r�r��=����������J�	�	�	�<�<�<�<�<r#r�c� �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
    )r���lengths r"rr2����v�&�&�&r#c�.�eZdZe��Zd�Zd�ZdS)�_MinLengthValidatorc	��t|��|jkr<td�|j|jt|��������dS)r-z*Length of '{name}' must be => {min}: {len})r.�minr�N)r��
min_lengthrMr4r.r6s    r"r:z_MinLengthValidator.__call__Br�r#c��d|j�d�S)Nz<min_len validator for r�)r�r>s r"r?z_MinLengthValidator.__repr__Mr�r#N)rBrCrDr
r�r:r?r%r#r"r�r�>r�r#r�c� �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
    )r�r�s r"rrQr�r#c�.�eZdZe��Zd�Zd�ZdS)�_SubclassOfValidatorc��t||j��s7td�|j|j|���||j|���dS)r-z8'{name}' must be a subclass of {type!r} (got {value!r}).)r.r/r1N)�
issubclassr/r3r4r.r6s    r"r:z_SubclassOfValidator.__call__asg���%���+�+�	��#�#)�6������$*�$�$�
��	��
�
�

�	�	r#c�8�d�|j���S)Nz)<subclass_of validator for type {type!r}>r<r=r>s r"r?z_SubclassOfValidator.__repr__rr@r#NrAr%r#r"r�r�]s=�������6�8�8�D����"
�
�
�
�
r#r�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
    `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.
    )r�r<s r"�_subclass_ofr�xrFr#c��eZdZe��Zeed�����Zeeee	��e
e��������Zd�Z
d�ZdS)�
_NotValidatorzCnot_ validator child '{validator!r}' did not raise a captured error)�	converterr�rqc���	|�|||��t|j�|j|j���||j||j���#|j$rYdSwxYw)N)rr�	exc_types)rrrMr�r4r�r6s    r"r:z_NotValidator.__call__�s���	��N�N�4��u�-�-�-������"�n�"�n� ���������	�	�	
���~�	�	�	��D�D�	���s�A�
A(�'A(c�D�d�|j|j���S)Nz;<not_ validator wrapping {what!r}, capturing {exc_types!r}>)rtr�)r4rrr�r>s r"r?z_NotValidator.__repr__�s(��L�
�&����n��
�
�	
r#N)rBrCrDr
rrrr�rr��	Exceptionrrwr�r:r?r%r#r"r�r��s�����������I�
�&�!�/�
-�
�
����C����-�)�\�)�4�4�*�{�5�1�1�
�
�
����I����"
�
�
�
�
r#r�)r�r�c�l�	t|��}n#t$r|f}YnwxYwt|||��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
    )rwr3r�)rrr�r�s   r"rr�sN��4!��)�$�$�	�	���!�!�!��L�	�	�	�!������C��3�3�3s��
"�")rNrp)5�__doc__r�rU�
contextlibrr�_configrr�_makerr	r
r�
convertersr�
exceptionsr
�__all__rrrr+rrIrrbrrnrryrr�rr�rr�rr�rrrrr�rr�rr�r�r�rMr3rr%r#r"�<module>r�s�����
����	�	�	�	�%�%�%�%�%�%�������;�;�;�;�;�;�;�;�5�5�5�5�5�5�5�5�5�5�5�5�'�'�'�'�'�'�(�(�(�(�(�(�����.%�%�%�$	$�	$�	$��!�!���!�"��E��D�)�)�)�
�
�
�
�
�
�
�*�)�
�6
&�
&�
&� ��E�$�d�+�+�+�
�
�
�
�
�
�
�,�+�
�2-4�-4�-4�-4�`��E��D�)�)�)�
�
�
�
�
�
�
�*�)�
�0)�)�)�6��E��D�)�)�)�
�
�
�
�
�
�
�*�)�
�)�)�)�&��E��D�)�)�)�
�
�
�
�
�
�
�*�)�
�2!�!�!�,��E��T�*�*�*�)�)�)�)�)�)�)�+�*�)�*"�"�"���E��D�)�)�)�
�
�
�
�
�
�
�*�)�
�>?�?�?�?�"��E��D�)�)�)�E�E�E�E�E�E�E�*�)�E�,
K�
K�
K�
K� ��E�$�d�+�+�+�
�
�
�
�
�
�
�,�+�
�2	3�	3�	3�	4�	4�	4�	4�	4�	4�	3�	3�	3���E�$�d�+�+�+�<�<�<�<�<�<�<�,�+�<�$	'�	'�	'���E�$�d�+�+�+�<�<�<�<�<�<�<�,�+�<�$	'�	'�	'���E��D�)�)�)�
�
�
�
�
�
�
�*�)�
�4
&�
&�
&� ��E��D�)�)�)�&
�&
�&
�&
�&
�&
�&
�*�)�&
�R �J�	�+B�4�4�4�4�4�4�4r#

?>