/opt/alt/python37/lib/python3.7/site-packages/attr/__pycache__
Edit: /opt/alt/python37/lib/python3.7/site-packages/attr/__pycache__/validators.cpython-37.pyc (11646B)
B
^u_, @ s d Z ddlmZmZmZ ddlZddlmZmZm Z m
Z
ddl m Z ddd d
d d d
ddg Z
e
ddddG dd deZdd Ze
ddddG dd deZd,dd
Ze
ddddG dd deZd d Ze
ddddG d d d eZd d Ze
ddddG d d! d!eZd"d
Ze
ddddG d#d$ d$eZd%d Ze
ddddG d&d' d'eZd-d(dZ e
ddddG d)d* d*eZ d.d+d Z dS )/z
Commonly useful validators.
)absolute_importdivisionprint_functionN )
_AndValidatorand_attribattrs)NotCallableErrorr
deep_iterable deep_mappingin_ instance_of is_callable
matches_reoptionalprovidesFT)reprslotshashc @ s" e Zd Ze Zdd Zdd ZdS )_InstanceOfValidatorc C s4 t || js0tdj|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}).)nametypeactualvalueN)
isinstancer TypeErrorformatr __class__)selfinstattrr r" @/opt/alt/python37/lib/python3.7/site-packages/attr/validators.py__call__ s z _InstanceOfValidator.__call__c C s dj | jdS )Nz)
)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 frozenr c @ s. e Zd Ze Ze Ze Zdd Zdd ZdS )_MatchesReValidatorc C s0 | |s,tdj|j| jj|d|| j|dS )zP
We use a callable class to be able to change the ``__repr__``.
z7'{name}' must match regex {regex!r} ({value!r} doesn't))r regexr N)
match_func
ValueErrorr r r+ pattern)r r r! r r" r" r# r$ L s
z _MatchesReValidator.__call__c C s dj | jdS )Nz,)r+ )r r+ )r r" r" r# r% [ s z _MatchesReValidator.__repr__N) r& r' r( r r+ flagsr, r$ r% r" r" r" r# r* F s
r* c C s t tdd}|dtjtjf}||krJtddtdd t|D f t| |}|tjkrh|j}n6|tjkrz|j}n$|r|j }ntd
| |}|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& ).0er" r" r# y s z matches_re..z(?:{})\Z) getattrresearchmatchr- joinsortedsetcompiler0 r r* )r+ r/ funcr0 Z valid_funcsr. r, 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 )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)r? Z
providedByr r r )r r r! r r" r" r# r$ s z_ProvidesValidator.__call__c C s dj | jdS )Nz0)r? )r r? )r r" r" r# r% s z_ProvidesValidator.__repr__N)r& r' r( 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 an object that does not provide the requested *interface* (checks are
performed using ``interface.providedBy(value)`` (see `zope.interface
`_).
:param interface: The interface to check for.
:type interface: ``zope.interface.Interface``
:raises TypeError: With a human readable error message, the attribute
(of type `attr.Attribute`), the expected interface, and the
value it got.
)r> )r? r" r" r# r s c @ s" e Zd Ze Zdd Zdd ZdS )_OptionalValidatorc C s |d kr d S | ||| d S )N) validator)r r r! r r" r" r# r$ s z_OptionalValidator.__call__c C s dj t| jdS )Nz')Zwhat)r r rA )r r" r" r# r% s z_OptionalValidator.__repr__N)r& r' r( r rA r$ r% r" r" r" r# r@ s r@ c C s t | trtt| 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 listr@ r )rA r" r" r# r s
c @ s" e Zd Ze Zdd Zdd ZdS ) _InValidatorc C sH y|| j k}W n tk
r& d}Y nX |sDtdj|j| j |dd S )NFz/'{name}' must be in {options!r} (got {value!r}))r optionsr )rD r r- r r )r r r! r Z
in_optionsr" r" r# r$ s
z_InValidator.__call__c C s dj | jdS )Nz()rD )r rD )r r" r" r# r% s z_InValidator.__repr__N)r& r' r( r rD r$ r% r" r" r" r# rC s
rC 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
)rC )rD r" r" r# r
s c @ s e Zd Zdd Zdd ZdS )_IsCallableValidatorc C s, t |s(d}t|j|j||jd|ddS )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# r$ s z _IsCallableValidator.__call__c C s dS )Nzr" )r r" r" r# r% s z _IsCallableValidator.__repr__N)r& r' r( r$ r% r" r" r" r# rE s rE 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.
)rE r" r" r" r# r s c @ s: e Zd Zee dZedee dZdd Zdd Z dS )
_DeepIterable)rA N)defaultrA c C s8 | j dk r| ||| x|D ]}| ||| q W dS )zP
We use a callable class to be able to change the ``__repr__``.
N)iterable_validatormember_validator)r r r! r memberr" r" r# r$ / s
z_DeepIterable.__call__c C s, | j d krdn dj| j d}dj|| jdS )N z
{iterable!r})iterablezJ)iterable_identifierrM )rK r rL )r rP r" r" r# r% 9 s
z_DeepIterable.__repr__)
r& r' r( r r rL r rK r$ r% r" r" r" r# rI ( s
rI 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
)rI )rL rK r" r" r# r H s c @ sF e Zd Zee dZee dZedee dZdd Z dd Z
dS ) _DeepMapping)rA N)rJ rA c C sJ | j dk r| ||| x,|D ]$}| ||| | |||| q W dS )zP
We use a callable class to be able to change the ``__repr__``.
N)mapping_validator
key_validatorvalue_validator)r r r! r keyr" r" r# r$ ] s
z_DeepMapping.__call__c C s dj | j| jdS )NzA)rU r )r rS rT )r r" r" r# r% h s z_DeepMapping.__repr__) r& r' r( r r rS rT r rR r$ r% r" r" r" r# rQ W s
rQ 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
)rQ )rS rT rR r" r" r# r n s
)r N)N)N) __doc__Z
__future__r r r r6 _maker r r r
exceptionsr
__all__objectr r r* r r> r r@ r rC r
rE r rI r rQ r r" r" r" r# sJ
-