OwlCyberSecurity - MANAGER
Edit File: validators.pyc
� Q��ac @` s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z d d l m Z m Z d d l m Z m Z m Z m Z d d l m Z y e j Z Wn& e k r� e e j d � � Z n Xd d d d d d d d d d d d d d d d d g Z d � Z d � Z e d � � Z e d e d e d e � d! e f d" � � Y� Z d# � Z e d e d$ e d e � d% e f d& � � Y� Z d d d' � Z" e d e d e d e � d( e f d) � � Y� Z# d* � Z$ e d e d e d e � d+ e f d, � � Y� Z% d- � Z& e d e d e d e � d. e f d/ � � Y� Z' d0 � Z( e d e d e d e � d1 e f d2 � � Y� Z) d3 � Z* e d e d e d e � d4 e f d5 � � Y� Z+ d d6 � Z, e d e d e d e � d7 e f d8 � � Y� Z- d d9 � Z. e d e d$ e d e � d: e f d; � � Y� Z/ d< � Z0 d= � Z1 d> � Z2 d? � Z3 e d e d$ e d e � d@ e f dA � � Y� Z4 dB � Z5 d S(C s Commonly useful validators. i ( t absolute_importt divisiont print_functionN( t contextmanageri ( t get_run_validatorst set_run_validators( t _AndValidatort and_t attribt attrs( t NotCallableErrort R t deep_iterablet deep_mappingt disabledt get get_disabledt gtt in_t instance_oft is_callablet let ltt matches_ret max_lent optionalt providest set_disabledc C` s t | � d S( s 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 ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR . s c C` s t � S( s� 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 ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR @ s c c` s% t t � z d VWd t t � Xd S( s� Context manager that disables running validators within its context. .. warning:: This context manager is not thread-safe! .. versionadded:: 21.3.0 N( R t Falset True( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR L s t reprt slotst hasht _InstanceOfValidatorc B` s# e Z e � Z d � Z d � Z RS( c C` sX t | | j � sT t d j d | j d | j d | j d | � | | j | � � n d S( 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}).t namet typet actualt valueN( t isinstanceR# t TypeErrort formatR" t __class__( t selft instt attrR% ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyt __call__b s c C` s d j d | j � S( Ns) <instance_of validator for type {type!r}>R# ( R( R# ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyt __repr__t s ( t __name__t __module__R R# R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR! ^ s c C` 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 `attrs.Attribute`), the expected type, and the value it got. ( R! ( R# ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR z s t frozent _MatchesReValidatorc B` s, e Z e � Z e � Z d � Z d � Z RS( c C` sO | j | � sK t d j d | j d | j j d | � | | j | � � n d S( sP We use a callable class to be able to change the ``__repr__``. s9 '{name}' must match regex {pattern!r} ({value!r} doesn't)R" t patternR% N( t match_funct ValueErrorR( R" R3 ( R* R+ R, R% ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- � s c C` s d j d | j � S( Ns. <matches_re validator for pattern {pattern!r}>R3 ( R( R3 ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. � s ( R/ R0 R R3 R4 R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR2 � s c C` s+ t t d d � } | d t j t j f } | | k rm t d j d j t d � t | � D� � � � � � n t | t � r� | r� t d � � n | } n t j | | � } | t j k r� | j } nW | t j k r� | j } n< | r� | j } n* t j d j | j � | j � } | j } t | | � S( s� 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 (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 .. versionchanged:: 21.3.0 *regex* can be a pre-compiled pattern. t fullmatchs 'func' must be one of {}.s , c s` s$ | ] } | r | j p d Vq d S( t NoneN( R/ ( t .0t e( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pys <genexpr>� s sR 'flags' can only be used with a string pattern; pass flags to re.compile() insteads (?:{})\ZN( t getattrt reR7 t searcht matchR5 R( t joint sortedt setR& t PatternR' t compileR6 R3 t flagsR2 ( t regexRC t funcR6 t valid_funcsR3 R4 ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR � s0 % t _ProvidesValidatorc B` s# e Z e � Z d � Z d � Z RS( c C` sO | j j | � sK t d j d | j d | j d | � | | j | � � n d S( sP We use a callable class to be able to change the ``__repr__``. s< '{name}' must provide {interface!r} which {value!r} doesn't.R" t interfaceR% N( RH t providedByR' R( R" ( R* R+ R, R% ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- � s c C` s d j d | j � S( Ns0 <provides validator for interface {interface!r}>RH ( R( RH ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. � s ( R/ R0 R RH R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyRG � s c C` 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 <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. ( RG ( RH ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR � s t _OptionalValidatorc B` s# e Z e � Z d � Z d � Z RS( c C` s' | d k r d S| j | | | � d S( N( R7 t validator( R* R+ R, R% ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- s c C` s d j d t | j � � S( Ns' <optional validator for {what} or None>t what( R( R RK ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. s ( R/ R0 R RK R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyRJ s c C` s) t | t � r t t | � � 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. ( R& t listRJ R ( RK ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR s t _InValidatorc B` s# e Z e � Z d � Z d � Z RS( c C` sd y | | j k } Wn t k r, t } n X| s` t d j d | j d | j d | � � � n d S( Ns/ '{name}' must be in {options!r} (got {value!r})R" t optionsR% ( RO R' R R5 R( R" ( R* R+ R, R% t in_options( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- + s c C` s d j d | j � S( Ns( <in_ validator with options {options!r}>RO ( R( RO ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. 8 s ( R/ R0 R RO R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyRN ' s c C` 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 `attrs.Attribute`), the expected options, and the value it got. .. versionadded:: 17.1.0 ( RN ( RO ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR > s t _IsCallableValidatorc B` s e Z d � Z d � Z RS( c C` sL t | � sH d } t d | j d | j d | d | j � d | � � n d S( 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}).t msgR" R% R$ N( t callableR R( R" R) ( R* R+ R, R% t message( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- R s c C` s d S( Ns <is_callable validator>( ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. b s ( R/ R0 R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyRQ P s c C` s t � S( sx 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. ( RQ ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR f s t _DeepIterablec B` sJ e Z e d e � � Z e d d d e e � � � Z d � Z d � Z RS( RK t defaultc C` sM | j d k r% | j | | | � n x! | D] } | j | | | � q, Wd S( sP We use a callable class to be able to change the ``__repr__``. N( t iterable_validatorR7 t member_validator( R* R+ R, R% t member( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- | s c C` sC | j d k r d n d j d | j � } d j d | d | j � S( NR s {iterable!r}t iterablesJ <deep_iterable validator for{iterable_identifier} iterables of {member!r}>t iterable_identifierRY ( RW R7 R( RX ( R* R[ ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. � s N( R/ R0 R R RX R7 R RW R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyRU u s c C` 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 ( RU ( RX RW ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR � s t _DeepMappingc B` s\ e Z e d e � � Z e d e � � Z e d d d e e � � � Z d � Z d � Z RS( RK RV c C` sd | j d k r% | j | | | � n x8 | D]0 } | j | | | � | j | | | | � q, Wd S( sP We use a callable class to be able to change the ``__repr__``. N( t mapping_validatorR7 t key_validatort value_validator( R* R+ R, R% t key( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- � s c C` s d j d | j d | j � S( NsA <deep_mapping validator for objects mapping {key!r} to {value!r}>R` R% ( R( R^ R_ ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. � s N( R/ R0 R R R^ R_ R7 R R] R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR\ � s c C` s t | | | � 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 ( R\ ( R^ R_ R] ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR � s t _NumberValidatorc B` s5 e Z e � Z e � Z e � Z d � Z d � Z RS( c C` sO | j | | j � sK t d j d | j d | j d | j d | � � � n d S( sP We use a callable class to be able to change the ``__repr__``. s& '{name}' must be {op} {bound}: {value}R" t opt boundR% N( t compare_funcRc R5 R( R" t compare_op( R* R+ R, R% ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- � s c C` s d j d | j d | j � S( Ns <Validator for x {op} {bound}>Rb Rc ( R( Re Rc ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. � s ( R/ R0 R Rc Re Rd R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyRa � s c C` s t | d t j � S( s� 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 t <( Ra t operatorR ( t val( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR � s c C` s t | d t j � S( s� 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 s <=( Ra Rg R ( Rh ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR � s c C` s t | d t j � S( s� 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 s >=( Ra Rg R ( Rh ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR � s c C` s t | d t j � S( s� 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 t >( Ra Rg R ( Rh ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR s t _MaxLengthValidatorc B` s# e Z e � Z d � Z d � Z RS( c C` sL t | � | j k rH t d j d | j d | j d t | � � � � n d S( sP We use a callable class to be able to change the ``__repr__``. s* Length of '{name}' must be <= {max}: {len}R" t maxt lenN( Rl t max_lengthR5 R( R" ( R* R+ R, R% ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR- s c C` s d j d | j � S( Ns <max_len validator for {max}>Rk ( R( Rm ( R* ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR. $ s ( R/ R0 R Rm R- R. ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyRj s c C` s t | � S( s� 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 ( Rj ( t length( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyR ( s (6 t __doc__t __future__R R R Rg R; t contextlibR t _configR R t _makeR R R R t exceptionsR RA t AttributeErrorR# RB t __all__R R R R R t objectR! R R2 R7 R RG R RJ R RN R RQ R RU R R\ R Ra R R R R Rj R ( ( ( sR /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/attr/validators.pyt <module> s� " 7