File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/attr/__pycache__/validators.cpython-310.pyc
Back
o ;j�L � @ 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 d+d,� Z!e dddd�G d-d.� d.��Z"dQd/d0�Z#e dddd�G d1d2� d2��Z$dQd3d4�Z%e dddd�G d5d6� d6��Z&d7d8� Z'd9d:� Z(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/dIdJ� Z0e dddd�G dKdL� dL��Z1de2e3fdM�dNdO�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�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 �C/opt/saltstack/salt/lib/python3.10/site-packages/attr/validators.pyr + s r 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 = � 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 I s � r FT)�repr�slots�hashc @ �" e Zd Ze� Zdd� Zdd� ZdS )�_InstanceOfValidatorc C s8 t || j�sdj|j| j|j|d�}t||| 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* �formatr) � __class__� TypeError��self�inst�attrr, �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__q � z _InstanceOfValidator.__repr__N��__name__� __module__� __qualname__r r* r6 r; r r r r! r' [ s 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). :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' r9 r r r! r u � r )r# �frozenr$ c @ s( e Zd Ze� Ze� Zdd� Zdd� ZdS )�_MatchesReValidatorc C s4 | � |�sdj|j| jj|d�}t||| j|��dS )r( z9'{name}' must match regex {pattern!r} ({value!r} doesn't))r) �patternr, N)� match_funcr. r) rE � ValueErrorr1 r r r! r6 � s ���z _MatchesReValidator.__call__c C r7 )Nz"<matches_re validator for pattern r8 )rE r: r r r! r; � r< z _MatchesReValidator.__repr__N)r> r? r@ r rE rF r6 r; r r r r! rD � s rD 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*. :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 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�matchr. �join�sorted�setrG r- r r0 �compilerD )Zregex�flags�funcZ valid_funcsr5 rE rF r r r! r � s( �� r c @ r& )�_ProvidesValidatorc C s4 | j �|�sdj|j| j |d�}t||| j |��dS )r( z<'{name}' must provide {interface!r} which {value!r} doesn't.)r) � interfacer, N)rW Z providedByr. r) r0 r1 r r r! r6 � s ���z_ProvidesValidator.__call__c C r7 )Nz"<provides validator for interface r8 )rW r: r r r! r; � r< z_ProvidesValidator.__repr__N)r> r? r@ r rW r6 r; r r r r! rV � � rV c C s ddl }|jdtdd� 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 r NzZattrs's zope-interface support is deprecated and will be removed in, or after, April 2024.� )� stacklevel)�warnings�warn�DeprecationWarningrV )rW r[ r r r! r � s �r c @ r& )�_OptionalValidatorc C s |d u rd S | � |||� d S �N�� validator�r2 r3 r4 r, r r r! r6 � s z_OptionalValidator.__call__c C r7 )Nz<optional validator for z or None>r` r: r r r! r; r< z_OptionalValidator.__repr__N)r> r? r@ r ra r6 r; r r r r! r^ � s r^ 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. :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. )r- �list�tupler^ r r` r r r! r s r c @ r& )� _InValidatorc C sZ z|| j v }W n ty d}Y nw |s+d|j� d| j �d|�d�}t||| j |��d S )NF�'z ' must be in � (got �))�optionsr0 r) rG )r2 r3 r4 r, Z in_optionsr5 r r r! r6 s � ��z_InValidator.__call__c C r7 )Nz <in_ validator with options r8 �ri r: r r r! r; . r< z_InValidator.__repr__N)r> r? r@ r ri r6 r; r r r r! re rX re c C rA )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. )re rj r r r! r 2 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) r, r+ )r5 r, N)�callabler r. r) r/ )r2 r3 r4 r, �messager r r! r6 J s � ���z _IsCallableValidator.__call__c C s dS )Nz<is_callable validator>r r: r r r! r; Z s z _IsCallableValidator.__repr__N)r> r? r@ r6 r; r r r r! rk H s rk c C s 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. )rk r r r r! r ^ s r c @ s: e Zd Zee� d�Zedee� �d�Zdd� Zdd� Z dS )� _DeepIterabler` N��defaultra c C s4 | j dur | � |||� |D ] }| �|||� qdS �r( N��iterable_validator�member_validator)r2 r3 r4 r, �memberr r r! r6 t 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 r8 rr )r2 Ziterable_identifierr r r! r; ~ s � ���z_DeepIterable.__repr__) r> r? r@ r r rt r rs r6 r; r r r r! rn m s � rn c C s 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 )r- rc rd r rn �rt rs r r r! r � s r c @ sF e Zd Zee� d�Zee� d�Zedee� �d�Zdd� Z dd� Z dS )� _DeepMappingr` Nro c C sF | j dur | � |||� |D ]}| �|||� | �|||| � qdS rq )�mapping_validator� key_validator�value_validator)r2 r3 r4 r, �keyr r r! r6 � s �z_DeepMapping.__call__c C � 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; � s �z_DeepMapping.__repr__) r> r? r@ r r r{ r| r rz r6 r; r r r r! ry � s ry 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 )ry )r{ r| rz 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( rf z ' must be rw �: N)� compare_func�boundr) � compare_oprG r1 r r r! r6 � s "�z_NumberValidator.__call__c C s d| j � d| j� d�S )Nz<Validator for x rw r8 )r� r� r: r r r! r; � s z_NumberValidator.__repr__N) r> r? r@ r r� r� r� r6 r; r r r r! r � s r c C � 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 ��valr r r! r � � r c C r� )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� r r� r r r! r � r� r c C r� )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� r r� r r r! r � r� r c C r� )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 r8 )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) rG r1 r r r! r6 � �z _MaxLengthValidator.__call__c C � d| j � d�S )Nz<max_len validator for r8 )r� r: r r r! r; r< z _MaxLengthValidator.__repr__N)r> r? r@ r r� r6 r; r r r r! r� � r� c C rA )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� ��lengthr r 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) rG r1 r r r! r6 $ r� z _MinLengthValidator.__call__c C r� )Nz<min_len validator for r8 )r� r: r r r! r; , r< z _MinLengthValidator.__repr__N)r> r? r@ r r� r6 r; r r r r! r� r� r� c C rA )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� r r r! r 0 r" r c @ r& )�_SubclassOfValidatorc C s< t || j�s d|j� d| j�d|�d�}t||| j|��dS )r( rf z' must be a subclass of rg z).N)� issubclassr* r) r0 r1 r r r! r6 @ s ��z _SubclassOfValidator.__call__c C r7 )Nz <subclass_of validator for type r8 r9 r: r r r! r; M r< z _SubclassOfValidator.__repr__Nr= r r r r! r� < s r� c C rA )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� r9 r r r! � _subclass_ofQ rB 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)� converterrx r` c C sN z | � |||� W n | jy Y d S w t| jj| j | jd�|| j || j��)N)ra � exc_types)ra r� rG r5 r. rb r r r! r6 q s ���z_NotValidator.__call__c C r~ )Nz;<not_ validator wrapping {what!r}, capturing {exc_types!r}>)Zwhatr� )r. ra r� r: r r r! r; � s �z_NotValidator.__repr__N)r> r? r@ r ra r r5 r r� � Exceptionr rd r� r6 r; r r r r! r� a s ���� r� )r5 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_(...))``. :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 )rd r0 r� )ra r5 r� r r r! r � s � r )r Nr_ )5�__doc__r� rL � contextlibr r Z_configr r �_maker r r r Z convertersr � exceptionsr �__all__r r r r' r rD r rV r r^ r re r rk r rn r ry r r r r r r r� r r� r r� r� r� rG r0 r r r r r! �<module> sp + )
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings