ó Wa›]c @`s[dZddlmZmZmZddlZddlmZmZm Z m Z ddl m Z ddd d d d d ddg Z e dededeƒdefd„ƒYƒZd„Ze dedeƒdefd„ƒYƒZddd„Ze dededeƒdefd„ƒYƒZd„Ze dededeƒdefd„ƒYƒZd„Ze dededeƒd efd!„ƒYƒZd"„Ze dededeƒd#efd$„ƒYƒZd%„Ze dededeƒd&efd'„ƒYƒZdd(„Ze dededeƒd)efd*„ƒYƒZ dd+„Z!dS(,s Commonly useful validators. i(tabsolute_importtdivisiontprint_functionNi(t _AndValidatortand_tattribtattrs(tNotCallableErrorRt deep_iterablet deep_mappingtin_t instance_oft is_callablet matches_retoptionaltprovidestreprtslotsthasht_InstanceOfValidatorcB`s#eZeƒZd„Zd„ZRS(c C`sXt||jƒsTtdjd|jd|jd|jd|ƒ||j|ƒ‚ndS(sP We use a callable class to be able to change the ``__repr__``. s?'{name}' must be {type!r} (got {value!r} that is a {actual!r}).tnamettypetactualtvalueN(t isinstanceRt TypeErrortformatRt __class__(tselftinsttattrR((s.lib/python2.7/site-packages/attr/validators.pyt__call__s    cC`sdjd|jƒS(Ns)R(RR(R((s.lib/python2.7/site-packages/attr/validators.pyt__repr__0s (t__name__t __module__RRRR (((s.lib/python2.7/site-packages/attr/validators.pyRs  cC`s t|ƒS(sÒ 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((s.lib/python2.7/site-packages/attr/validators.pyR 6s tfrozent_MatchesReValidatorcB`s5eZeƒZeƒZeƒZd„Zd„ZRS(cC`sO|j|ƒsKtdjd|jd|jjd|ƒ||j|ƒ‚ndS(sP We use a callable class to be able to change the ``__repr__``. s7'{name}' must match regex {regex!r} ({value!r} doesn't)RtregexRN(t match_funct ValueErrorRRR%tpattern(RRRR((s.lib/python2.7/site-packages/attr/validators.pyRLs cC`sdjd|jƒS(Ns,R%(RR%(R((s.lib/python2.7/site-packages/attr/validators.pyR [s (R!R"RR%tflagsR&RR (((s.lib/python2.7/site-packages/attr/validators.pyR$Fs     cC`sùttddƒ}|dtjtjf}||krktddjtd„t|ƒDƒƒƒfƒ‚ntj ||ƒ}|tjkr˜|j}nQ|tjkr³|j}n6|rÅ|j }n$tj dj |ƒ|ƒ}|j}t |||ƒS(s} 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 t fullmatchs'func' must be one of %s.s, cs`s$|]}|r|jpdVqdS(tNoneN(R!(t.0te((s.lib/python2.7/site-packages/attr/validators.pys yss(?:{})\ZN( tgetattrtreR+tsearchtmatchR'tjointsortedtsettcompileR*RR$(R%R)tfuncR*t valid_funcsR(R&((s.lib/python2.7/site-packages/attr/validators.pyR as$ &    t_ProvidesValidatorcB`s#eZeƒZd„Zd„ZRS(cC`sO|jj|ƒsKtdjd|jd|jd|ƒ||j|ƒ‚ndS(sP We use a callable class to be able to change the ``__repr__``. s<'{name}' must provide {interface!r} which {value!r} doesn't.Rt interfaceRN(R9t providedByRRR(RRRR((s.lib/python2.7/site-packages/attr/validators.pyR’s cC`sdjd|jƒS(Ns0R9(RR9(R((s.lib/python2.7/site-packages/attr/validators.pyR ¡s (R!R"RR9RR (((s.lib/python2.7/site-packages/attr/validators.pyR8Žs  cC`s t|ƒS(s 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 zope.interface.Interface interface: The interface to check for. :raises TypeError: With a human readable error message, the attribute (of type `attr.Attribute`), the expected interface, and the value it got. (R8(R9((s.lib/python2.7/site-packages/attr/validators.pyR§s t_OptionalValidatorcB`s#eZeƒZd„Zd„ZRS(cC`s'|dkrdS|j|||ƒdS(N(R+t validator(RRRR((s.lib/python2.7/site-packages/attr/validators.pyR»s cC`sdjdt|jƒƒS(Ns'twhat(RRR<(R((s.lib/python2.7/site-packages/attr/validators.pyR Ás (R!R"RR<RR (((s.lib/python2.7/site-packages/attr/validators.pyR;·s  cC`s)t|tƒrtt|ƒƒSt|ƒS(s 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. (RtlistR;R(R<((s.lib/python2.7/site-packages/attr/validators.pyRÇs t _InValidatorcB`s#eZeƒZd„Zd„ZRS(cC`sdy||jk}Wntk r,t}nX|s`tdjd|jd|jd|ƒƒ‚ndS(Ns/'{name}' must be in {options!r} (got {value!r})RtoptionsR(R@RtFalseR'RR(RRRRt in_options((s.lib/python2.7/site-packages/attr/validators.pyRÝs   cC`sdjd|jƒS(Ns(R@(RR@(R((s.lib/python2.7/site-packages/attr/validators.pyR ês (R!R"RR@RR (((s.lib/python2.7/site-packages/attr/validators.pyR?Ùs  cC`s t|ƒS(sÛ 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 (R?(R@((s.lib/python2.7/site-packages/attr/validators.pyR ðst_IsCallableValidatorcB`seZd„Zd„ZRS(c C`sLt|ƒsHd}td|jd|jd|d|jƒd|ƒ‚ndS(sP We use a callable class to be able to change the ``__repr__``. s?'{name}' must be callable (got {value!r} that is a {actual!r}).tmsgRRRN(tcallableRRRR(RRRRtmessage((s.lib/python2.7/site-packages/attr/validators.pyRs   cC`sdS(Ns((R((s.lib/python2.7/site-packages/attr/validators.pyR s(R!R"RR (((s.lib/python2.7/site-packages/attr/validators.pyRCs cC`stƒS(sw 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. (RC(((s.lib/python2.7/site-packages/attr/validators.pyR s t _DeepIterablecB`sJeZedeƒƒZedddeeƒƒƒZd„Zd„Z RS(R<tdefaultcC`sM|jdk r%|j|||ƒnx!|D]}|j|||ƒq,WdS(sP We use a callable class to be able to change the ``__repr__``. N(titerable_validatorR+tmember_validator(RRRRtmember((s.lib/python2.7/site-packages/attr/validators.pyR.s cC`sC|jdkrdndjd|jƒ}djd|d|jƒS(Nts {iterable!r}titerablesJtiterable_identifierRK(RIR+RRJ(RRN((s.lib/python2.7/site-packages/attr/validators.pyR 8s  N( R!R"RR RJR+RRIRR (((s.lib/python2.7/site-packages/attr/validators.pyRG's  cC`s t||ƒS(s1 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 (RG(RJRI((s.lib/python2.7/site-packages/attr/validators.pyRGs t _DeepMappingcB`s\eZedeƒƒZedeƒƒZedddeeƒƒƒZd„Z d„Z RS(R<RHcC`sd|jdk r%|j|||ƒnx8|D]0}|j|||ƒ|j||||ƒq,WdS(sP We use a callable class to be able to change the ``__repr__``. N(tmapping_validatorR+t key_validatortvalue_validator(RRRRtkey((s.lib/python2.7/site-packages/attr/validators.pyR\s  cC`sdjd|jd|jƒS(NsARSR(RRQRR(R((s.lib/python2.7/site-packages/attr/validators.pyR gs N( R!R"RR RQRRR+RRPRR (((s.lib/python2.7/site-packages/attr/validators.pyROVs  cC`st|||ƒS(s} 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 (RO(RQRRRP((s.lib/python2.7/site-packages/attr/validators.pyR ms ("t__doc__t __future__RRRR/t_makeRRRRt exceptionsRt__all__RAtTruetobjectRR R$R+R R8RR;RR?R RCR RGRROR (((s.lib/python2.7/site-packages/attr/validators.pytsJ "  -