/usr/local/lib/python3.6/site-packages/attr/__pycache__
Edit: /usr/local/lib/python3.6/site-packages/attr/__pycache__/validators.cpython-36.pyc (20703B)
3
8%EgP @ 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)dZ 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 d1Z!d2d Z"e d d d!d"G d3d4 d4Z#d5d Z$e d d!d!d"G d6d7 d7Z%dQd8d Z&e d d!d!d"G d9d: d:Z'dRd;d Z(e d d!d!d&G d
d Z*d?d Z+d@d Z,dAd Z-e d d!d!d&G dBdC dCZ.dDd Z/e d d!d!d&G dEdF dFZ0dGd Z1e d d!d!d"G dHdI dIZ2dJdK Z3e d d!d!d"G dLdM dMZ4de5e6fdNdOdZ7dS )Sz
Commonly useful validators.
N)contextmanager )get_run_validatorsset_run_validators)
_AndValidatorand_attribattrs)default_if_none)NotCallableError r
deep_iterable deep_mappingdisabledge get_disabledgtin_ instance_of is_callablelelt
matches_remax_lenmin_lennot_optionalprovides 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 9/usr/local/lib/python3.6/site-packages/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)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 r r __call__d s z _InstanceOfValidator.__call__c C s dj | jdS )Nz))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 | jdS )Nz.)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 ).0er r r s z matches_re..zR'flags' can only be used with a string pattern; pass flags to re.compile() instead)re fullmatchsearchmatchr9 r+ joinsortedsetr) Patternr* compiler6 )regexflagsfuncZ 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 | jdS )Nz0)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
`_).
: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| jdS )Nz')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 | 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) 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 | jdS )Nz()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|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 r0 T s z _IsCallableValidator.__call__c C s dS )Nzr )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 dZedee dZdd 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_validatormember_validator)r- r. r/ r( memberr r r r0 ~ s
z_DeepIterable.__call__c C s* | j d krdn
d| j }dj|| jdS )Nr zJ)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 | ttfrt| } 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 dZee dZedee dZdd 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_validatorvalue_validator)r- r. r/ r( keyr r r r0 s
z_DeepMapping.__call__c C s dj | j| jdS )NzA)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 || js*tdj|j| j| j|ddS )zP
We use a callable class to be able to change the ``__repr__``.
z&'{name}' must be {op} {bound}: {value})r% opboundr( 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| jdS )Nz )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 | dtjS )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 | dtjS )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 | dtjS )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 | dtjS )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 |ddS )zP
We use a callable class to be able to change the ``__repr__``.
z*Length of '{name}' must be <= {max}: {len})r% maxlenN)rn
max_lengthr9 r+ r% )r- r. r/ r( r r r r0 s z _MaxLengthValidator.__call__c C s d| j dS )Nz {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 dS )Nz)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 ZeeddZeeee e
e ddZ 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 || jd 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| jdS )Nz;)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 _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 s|
0
*