MINI MINI MANI MO

Path : /lib/python2.7/site-packages/
File Upload :
Current File : //lib/python2.7/site-packages/validate.pyc

ó
C¬–Sc@s¾dZdZdddddddd	d
ddd
ddddddddddddddddfZddlZejd ejejBƒZejd!ejejBƒZd"Z	d#e	Z
yeWnek
rÞd$„ZnXd%„Z
d&„Zdefd'„ƒYZdefd(„ƒYZdefd)„ƒYZdefd*„ƒYZdefd+„ƒYZd	efd,„ƒYZd
efd-„ƒYZdefd.„ƒYZdefd/„ƒYZd
efd0„ƒYZdefd1„ƒYZed2„Zeed3„Z eed4„Z!i
e"e"6e"d56e"d66e"d76e"d86ee6ed96ed:6ed;6ed<6Z#d=„Z$d>„Z%eed?„Z&eed@„Z'eedA„Z(eedB„Z)eedC„Z*eedD„Z+eedE„Z,eedF„Z-eedG„Z.ie dH6e!dI6e%dJ6e(dK6e$dL6Z/dM„Z0dN„Z1dO„Z2dP„Z3dQ„Z4e5dRkrºddl6Z6ddl7Z7e6j8j9dRƒZ:e:j;j<ƒZ=e=j>ieƒdS6ƒe7j?e:dTe=ƒndS(Us
    The Validator object is used to check that supplied values 
    conform to a specification.
    
    The value can be supplied as a string - e.g. from a config file.
    In this case the check will also *convert* the value to
    the required type. This allows you to add validation
    as a transparent layer to access data stored as strings.
    The validation checks that the data is correct *and*
    converts it to the expected type.
    
    Some standard checks are provided for basic data types.
    Additional checks are easy to write. They can be
    provided when the ``Validator`` is instantiated or
    added afterwards.
    
    The standard functions work with the following basic data types :
    
    * integers
    * floats
    * booleans
    * strings
    * ip_addr
    
    plus lists of these datatypes
    
    Adding additional checks is done through coding simple functions.
    
    The full set of standard checks are : 
    
    * 'integer': matches integer values (including negative)
                 Takes optional 'min' and 'max' arguments : ::
    
                   integer()
                   integer(3, 9)  # any value from 3 to 9
                   integer(min=0) # any positive value
                   integer(max=9)
    
    * 'float': matches float values
               Has the same parameters as the integer check.
    
    * 'boolean': matches boolean values - ``True`` or ``False``
                 Acceptable string values for True are :
                   true, on, yes, 1
                 Acceptable string values for False are :
                   false, off, no, 0
    
                 Any other value raises an error.
    
    * 'ip_addr': matches an Internet Protocol address, v.4, represented
                 by a dotted-quad string, i.e. '1.2.3.4'.
    
    * 'string': matches any string.
                Takes optional keyword args 'min' and 'max'
                to specify min and max lengths of the string.
    
    * 'list': matches any list.
              Takes optional keyword args 'min', and 'max' to specify min and
              max sizes of the list. (Always returns a list.)
    
    * 'tuple': matches any tuple.
              Takes optional keyword args 'min', and 'max' to specify min and
              max sizes of the tuple. (Always returns a tuple.)
    
    * 'int_list': Matches a list of integers.
                  Takes the same arguments as list.
    
    * 'float_list': Matches a list of floats.
                    Takes the same arguments as list.
    
    * 'bool_list': Matches a list of boolean values.
                   Takes the same arguments as list.
    
    * 'ip_addr_list': Matches a list of IP addresses.
                     Takes the same arguments as list.
    
    * 'string_list': Matches a list of strings.
                     Takes the same arguments as list.
    
    * 'mixed_list': Matches a list with different types in 
                    specific positions. List size must match
                    the number of arguments.
    
                    Each position can be one of :
                    'integer', 'float', 'ip_addr', 'string', 'boolean'
    
                    So to specify a list with two strings followed
                    by two integers, you write the check as : ::
    
                      mixed_list('string', 'string', 'integer', 'integer')
    
    * 'pass': This check matches everything ! It never fails
              and the value is unchanged.
    
              It is also the default if no check is specified.
    
    * 'option': This check matches any from a list of options.
                You specify this check with : ::
    
                  option('option 1', 'option 2', 'option 3')
    
    You can supply a default value (returned if no value is supplied)
    using the default keyword argument.
    
    You specify a list argument for default using a list constructor syntax in
    the check : ::
    
        checkname(arg1, arg2, default=list('val 1', 'val 2', 'val 3'))
    
    A badly formatted set of arguments will raise a ``VdtParamError``.
s1.0.1t__version__tdottedQuadToNumtnumToDottedQuadt
ValidateErrortVdtUnknownCheckErrort
VdtParamErrortVdtTypeErrort
VdtValueErrortVdtValueTooSmallErrortVdtValueTooBigErrortVdtValueTooShortErrortVdtValueTooLongErrortVdtMissingValuet	Validatort
is_integertis_floatt
is_booleantis_listtis_tuplet
is_ip_addrt	is_stringtis_int_listtis_bool_listt
is_float_listtis_string_listtis_ip_addr_listt
is_mixed_listt	is_optioniÿÿÿÿNs¢
    (?:
        ([a-zA-Z_][a-zA-Z0-9_]*)\s*=\s*list\(
            (
                (?:
                    \s*
                    (?:
                        (?:".*?")|              # double quotes
                        (?:'.*?')|              # single quotes
                        (?:[^'",\s\)][^,\)]*?)  # unquoted
                    )
                    \s*,\s*
                )*
                (?:
                    (?:".*?")|              # double quotes
                    (?:'.*?')|              # single quotes
                    (?:[^'",\s\)][^,\)]*?)  # unquoted
                )?                          # last one
            )
        \)
    )
sÕ
    (
        (?:".*?")|              # double quotes
        (?:'.*?')|              # single quotes
        (?:[^'",\s=][^,=]*?)       # unquoted
    )
    (?:
    (?:\s*,\s*)|(?:\s*$)            # comma
    )
s
    (?:
        (
            (?:
                [a-zA-Z_][a-zA-Z0-9_]*\s*=\s*list\(
                    (?:
                        \s*
                        (?:
                            (?:".*?")|              # double quotes
                            (?:'.*?')|              # single quotes
                            (?:[^'",\s\)][^,\)]*?)       # unquoted
                        )
                        \s*,\s*
                    )*
                    (?:
                        (?:".*?")|              # double quotes
                        (?:'.*?')|              # single quotes
                        (?:[^'",\s\)][^,\)]*?)       # unquoted
                    )?                              # last one
                \)
            )|
            (?:
                (?:".*?")|              # double quotes
                (?:'.*?')|              # single quotes
                (?:[^'",\s=][^,=]*?)|       # unquoted
                (?:                         # keyword argument
                    [a-zA-Z_][a-zA-Z0-9_]*\s*=\s*
                    (?:
                        (?:".*?")|              # double quotes
                        (?:'.*?')|              # single quotes
                        (?:[^'",\s=][^,=]*?)       # unquoted
                    )
                )
            )
        )
        (?:
            (?:\s*,\s*)|(?:\s*$)            # comma
        )
    )
    s^%s*cCs|r
dSdSdS(s$Simple boolean equivalent function. iiN((tval((s,/usr/lib/python2.7/site-packages/validate.pytboolúscCs€ddl}ddl}y'|jd|j|jƒƒƒdSWn:|jk
r{|jƒdkrhdStd|ƒ‚nXdS(sÎ
    Convert decimal dotted quad string to long integer
    
    >>> int(dottedQuadToNum('1 '))
    1
    >>> int(dottedQuadToNum(' 1.2'))
    16777218
    >>> int(dottedQuadToNum(' 1.2.3 '))
    16908291
    >>> int(dottedQuadToNum('1.2.3.4'))
    16909060
    >>> dottedQuadToNum('255.255.255.255')
    4294967295L
    >>> dottedQuadToNum('255.255.255.256')
    Traceback (most recent call last):
    ValueError: Not a good dotted-quad IP: 255.255.255.256
    iÿÿÿÿNs!Lis255.255.255.255lÿÿsNot a good dotted-quad IP: %s(tsockettstructtunpackt	inet_atontstripterrort
ValueError(tipRR((s,/usr/lib/python2.7/site-packages/validate.pyRs	cCsddl}ddl}|dks0|dkrCtd|ƒ‚ny#|j|jdt|ƒƒƒSWn0|j|jtfk
r˜td|ƒ‚nXdS(s
    Convert long int to dotted quad string
    
    >>> numToDottedQuad(-1L)
    Traceback (most recent call last):
    ValueError: Not a good numeric IP: -1
    >>> numToDottedQuad(1L)
    '0.0.0.1'
    >>> numToDottedQuad(16777218L)
    '1.0.0.2'
    >>> numToDottedQuad(16908291L)
    '1.2.0.3'
    >>> numToDottedQuad(16909060L)
    '1.2.3.4'
    >>> numToDottedQuad(4294967295L)
    '255.255.255.255'
    >>> numToDottedQuad(4294967296L)
    Traceback (most recent call last):
    ValueError: Not a good numeric IP: 4294967296
    iÿÿÿÿNlÿÿisNot a good numeric IP: %ss!L(RRR$t	inet_ntoatpacktlongR#t
OverflowError(tnumRR((s,/usr/lib/python2.7/site-packages/validate.pyR$scBseZdZRS(s
    This error indicates that the check failed.
    It can be the base class for more specific errors.
    
    Any check function that fails ought to raise this error.
    (or a subclass)
    
    >>> raise ValidateError
    Traceback (most recent call last):
    ValidateError
    (t__name__t
__module__t__doc__(((s,/usr/lib/python2.7/site-packages/validate.pyRGscBseZdZRS(s1No value was supplied to a check that needed one.(R+R,R-(((s,/usr/lib/python2.7/site-packages/validate.pyRUscBseZdZd„ZRS(s'An unknown check function was requestedcCstj|d|fƒdS(sž
        >>> raise VdtUnknownCheckError('yoda')
        Traceback (most recent call last):
        VdtUnknownCheckError: the check "yoda" is unknown.
        sthe check "%s" is unknown.N(Rt__init__(tselftvalue((s,/usr/lib/python2.7/site-packages/validate.pyR.\s(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyRYscBseZdZd„ZRS(s!An incorrect parameter was passedcCstj|d||fƒdS(s²
        >>> raise VdtParamError('yoda', 'jedi')
        Traceback (most recent call last):
        VdtParamError: passed an incorrect value "jedi" for parameter "yoda".
        s2passed an incorrect value "%s" for parameter "%s".N(tSyntaxErrorR.(R/tnameR0((s,/usr/lib/python2.7/site-packages/validate.pyR.hs(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyRescBseZdZd„ZRS(s(The value supplied was of the wrong typecCstj|d|fƒdS(s˜
        >>> raise VdtTypeError('jedi')
        Traceback (most recent call last):
        VdtTypeError: the value "jedi" is of the wrong type.
        s$the value "%s" is of the wrong type.N(RR.(R/R0((s,/usr/lib/python2.7/site-packages/validate.pyR.ts(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyRqscBseZdZd„ZRS(sIThe value supplied was of the correct type, but was not an allowed value.cCstj|d|fƒdS(s•
        >>> raise VdtValueError('jedi')
        Traceback (most recent call last):
        VdtValueError: the value "jedi" is unacceptable.
        sthe value "%s" is unacceptable.N(RR.(R/R0((s,/usr/lib/python2.7/site-packages/validate.pyR.€s(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyR}scBseZdZd„ZRS(s>The value supplied was of the correct type, but was too small.cCstj|d|fƒdS(sœ
        >>> raise VdtValueTooSmallError('0')
        Traceback (most recent call last):
        VdtValueTooSmallError: the value "0" is too small.
        sthe value "%s" is too small.N(RR.(R/R0((s,/usr/lib/python2.7/site-packages/validate.pyR.Œs(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyR‰scBseZdZd„ZRS(s<The value supplied was of the correct type, but was too big.cCstj|d|fƒdS(s–
        >>> raise VdtValueTooBigError('1')
        Traceback (most recent call last):
        VdtValueTooBigError: the value "1" is too big.
        sthe value "%s" is too big.N(RR.(R/R0((s,/usr/lib/python2.7/site-packages/validate.pyR.˜s(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyR	•scBseZdZd„ZRS(s>The value supplied was of the correct type, but was too short.cCstj|d|fƒdS(s 
        >>> raise VdtValueTooShortError('jed')
        Traceback (most recent call last):
        VdtValueTooShortError: the value "jed" is too short.
        sthe value "%s" is too short.N(RR.(R/R0((s,/usr/lib/python2.7/site-packages/validate.pyR.¤s(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyR
¡scBseZdZd„ZRS(s=The value supplied was of the correct type, but was too long.cCstj|d|fƒdS(s¡
        >>> raise VdtValueTooLongError('jedie')
        Traceback (most recent call last):
        VdtValueTooLongError: the value "jedie" is too long.
        sthe value "%s" is too long.N(RR.(R/R0((s,/usr/lib/python2.7/site-packages/validate.pyR.²s(R+R,R-R.(((s,/usr/lib/python2.7/site-packages/validate.pyR¯scBsÜeZdZejdejƒZejdejƒZeZe	Z	eje
ejejBƒZeje
ejejBƒZd
d„Zed„Zd„Zd„Zd„Zd„Zd	„Zd
„Zd„Zd„ZRS(s(

    Validator is an object that allows you to register a set of 'checks'.
    These checks take input and test that it conforms to the check.
    
    This can also involve converting the value from a string into
    the correct datatype.
    
    The ``check`` method takes an input string which configures which
    check is to be used and applies that check to a supplied value.
    
    An example input string would be:
    'int_range(param1, param2)'
    
    You would then provide something like:
    
    >>> def int_range_check(value, min, max):
    ...     # turn min and max from strings to integers
    ...     min = int(min)
    ...     max = int(max)
    ...     # check that value is of the correct type.
    ...     # possible valid inputs are integers or strings
    ...     # that represent integers
    ...     if not isinstance(value, (int, long, basestring)):
    ...         raise VdtTypeError(value)
    ...     elif isinstance(value, basestring):
    ...         # if we are given a string
    ...         # attempt to convert to an integer
    ...         try:
    ...             value = int(value)
    ...         except ValueError:
    ...             raise VdtValueError(value)
    ...     # check the value is between our constraints
    ...     if not min <= value:
    ...          raise VdtValueTooSmallError(value)
    ...     if not value <= max:
    ...          raise VdtValueTooBigError(value)
    ...     return value
    
    >>> fdict = {'int_range': int_range_check}
    >>> vtr1 = Validator(fdict)
    >>> vtr1.check('int_range(20, 40)', '30')
    30
    >>> vtr1.check('int_range(20, 40)', '60')
    Traceback (most recent call last):
    VdtValueTooBigError: the value "60" is too big.
    
    New functions can be added with : ::
    
    >>> vtr2 = Validator()       
    >>> vtr2.functions['int_range'] = int_range_check
    
    Or by passing in a dictionary of functions when Validator 
    is instantiated.
    
    Your functions *can* use keyword arguments,
    but the first argument should always be 'value'.
    
    If the function doesn't take additional arguments,
    the parentheses are optional in the check.
    It can be written with either of : ::
    
        keyword = function_name
        keyword = function_name()
    
    The first program to utilise Validator() was Michael Foord's
    ConfigObj, an alternative to ConfigParser which supports lists and
    can validate a config file using a config schema.
    For more details on using Validator with ConfigObj see:
    http://www.voidspace.org.uk/python/configobj.html
    s
(.+?)\((.*)\)s%^([a-zA-Z_][a-zA-Z0-9_]*)\s*=\s*(.*)$cCs»i|jd6td6td6td6td6td6td6td6td	6t	d
6t
d6td6td
6t
d6|jd6td6td6|_|dk	r¥|jj|ƒnt|_i|_dS(s(
        >>> vtri = Validator()
        ttintegertfloattbooleantip_addrtstringtlistttupletint_listt
float_listt	bool_listtip_addr_listtstring_listt
mixed_listtpasstoptiont
force_listN(t_passRRRRRRRRRRRRRRRCt	functionstNonetupdateRtbaseErrorClasst_cache(R/RE((s,/usr/lib/python2.7/site-packages/validate.pyR.s,


	cCsq|j|ƒ\}}}}|rK|dkr9tƒ‚n|j|ƒ}n|dkr[dS|j||||ƒS(s´
        Usage: check(check, value)
        
        Arguments:
            check: string representing check to apply (including arguments)
            value: object to be checked
        Returns value, converted to correct type if necessary
        
        If the check fails, raises a ``ValidateError`` subclass.
        
        >>> vtor.check('yoda', '')
        Traceback (most recent call last):
        VdtUnknownCheckError: the check "yoda" is unknown.
        >>> vtor.check('yoda()', '')
        Traceback (most recent call last):
        VdtUnknownCheckError: the check "yoda" is unknown.
        
        >>> vtor.check('string(default="")', '', missing=True)
        ''
        N(t_parse_with_cachingRFRt_handle_nonet_check_value(R/tcheckR0tmissingtfun_nametfun_argst
fun_kwargstdefault((s,/usr/lib/python2.7/site-packages/validate.pyRM4scCs2|dkrdS|dkr.|j|ƒ}n|S(NRFs'None's"None"(s'None's"None"(RFt_unquote(R/R0((s,/usr/lib/python2.7/site-packages/validate.pyRKWs
cCsÊ||jkrC|j|\}}}}t|ƒ}t|ƒ}nw|j|ƒ\}}}}tg|jƒD]\}}t|ƒ|f^qnƒ}|t|ƒt|ƒ|f|j|<||||fS(N(RIR9tdictt_parse_checktitemststr(R/RMRORPRQRRtkeyR0((s,/usr/lib/python2.7/site-packages/validate.pyRJ`s7%cCsEy|j|}Wntk
r0t|ƒ‚nX||||ŽSdS(N(REtKeyErrorR(R/R0RORPRQtfun((s,/usr/lib/python2.7/site-packages/validate.pyRLns

cCs‚|jj|ƒ}|rP|jdƒ}|jdƒ}|jj|ƒ}|dkrgtd|ƒ‚ng}i}xê|jj|ƒD]Ã}|jƒ}|j	j|ƒ}	|	rÕ|j
|	ƒ\}
}|||
<q†n|jj|ƒ}|r3|jdƒ}|dkr|j|ƒ}n|||jdƒ<q†n|j
|j|ƒƒq†Wn|didfS|jddƒ}
||||
fS(	NiisBad syntax in check "%s".s'None's"None"RR(s'None's"None"((t_func_retmatchtgroupt_matchfinderRFRt_paramfindertfindallR"t	_list_argt_list_handlet_key_argRStappendtpop(R/RMt	fun_matchROt
arg_stringt	arg_matchRPRQtargt	listmatchRXRtkeymatchRR((s,/usr/lib/python2.7/site-packages/validate.pyRUws6
cCsJt|ƒdkrF|ddkrF|d|dkrF|dd!}n|S(sUnquote a value if necessary.iit't"iÿÿÿÿi(RlRm(tlen(R/R((s,/usr/lib/python2.7/site-packages/validate.pyRSŸs6cCsag}|jdƒ}|jdƒ}x0|jj|ƒD]}|j|j|ƒƒq7W||fS(s7Take apart a ``keyword=list('val, 'val')`` type string.ii(R]t
_list_membersR`RdRS(R/RjtoutR2targsRi((s,/usr/lib/python2.7/site-packages/validate.pyRb¦scCs|S(s
        Dummy check that always passes
        
        >>> vtor.check('', 0)
        0
        >>> vtor.check('', '0')
        '0'
        ((R/R0((s,/usr/lib/python2.7/site-packages/validate.pyRD°s	cCso|j|ƒ\}}}}|dkr:td|ƒ‚n|j|ƒ}|dkrY|S|j||||ƒS(sØ
        Given a check, return the default value for the check
        (converted to the right type).
        
        If the check doesn't specify a default value then a
        ``KeyError`` will be raised.
        s Check "%s" has no default value.N(RJRFRYRKRL(R/RMRORPRQRRR0((s,/usr/lib/python2.7/site-packages/validate.pytget_default_value¼sN(R+R,R-tretcompiletDOTALLR[RcRaRot_paramstringtVERBOSER_t_matchstringR^RFR.tFalseRMRKRJRLRURSRbRDRr(((s,/usr/lib/python2.7/site-packages/validate.pyR
»s"F#						(		
	c	CsÁ|rtpt}g}x¢t||ƒD]‘\}}|dkrP|j|ƒq(t|ttttfƒrªy|j||ƒƒWq¹tk
r¦}t	||ƒ‚q¹Xq(t	||ƒ‚q(W|S(sÖ
    Return numbers from inputs or raise VdtParamError.
    
    Lets ``None`` pass through.
    Pass in keyword argument ``to_float=True`` to
    use float for the conversion rather than int.
    
    >>> _is_num_param(('', ''), (0, 1.0))
    [0, 1]
    >>> _is_num_param(('', ''), (0, 1.0), to_float=True)
    [0.0, 1.0]
    >>> _is_num_param(('a'), ('a'))
    Traceback (most recent call last):
    VdtParamError: passed an incorrect value "a" for parameter "a".
    N(
R5tinttzipRFRdt
isinstanceR(t
basestringR$R(tnamestvaluestto_floatRZt
out_paramsR2Rte((s,/usr/lib/python2.7/site-packages/validate.pyt
_is_num_paramÍscCsÖtd||fƒ\}}t|tttfƒsBt|ƒ‚nt|tƒr„yt|ƒ}Wq„tk
r€t|ƒ‚q„Xn|dk	r«||kr«t|ƒ‚n|dk	rÒ||krÒt	|ƒ‚n|S(sH
    A check that tests that a given value is an integer (int, or long)
    and optionally, between bounds. A negative value is accepted, while
    a float will fail.
    
    If the value is a string, then the conversion is done - if possible.
    Otherwise a VdtError is raised.
    
    >>> vtor.check('integer', '-1')
    -1
    >>> vtor.check('integer', '0')
    0
    >>> vtor.check('integer', 9)
    9
    >>> vtor.check('integer', 'a')
    Traceback (most recent call last):
    VdtTypeError: the value "a" is of the wrong type.
    >>> vtor.check('integer', '2.2')
    Traceback (most recent call last):
    VdtTypeError: the value "2.2" is of the wrong type.
    >>> vtor.check('integer(10)', '20')
    20
    >>> vtor.check('integer(max=20)', '15')
    15
    >>> vtor.check('integer(10)', '9')
    Traceback (most recent call last):
    VdtValueTooSmallError: the value "9" is too small.
    >>> vtor.check('integer(10)', 9)
    Traceback (most recent call last):
    VdtValueTooSmallError: the value "9" is too small.
    >>> vtor.check('integer(max=20)', '35')
    Traceback (most recent call last):
    VdtValueTooBigError: the value "35" is too big.
    >>> vtor.check('integer(max=20)', 35)
    Traceback (most recent call last):
    VdtValueTooBigError: the value "35" is too big.
    >>> vtor.check('integer(0, 9)', False)
    0
    tmintmax(sminsmaxN(
RƒR|RzR(R}RR$RFRR	(R0R„R…tmin_valtmax_val((s,/usr/lib/python2.7/site-packages/validate.pyRòs(
cCsßtd||fdtƒ\}}t|ttttfƒsKt|ƒ‚nt|tƒsyt|ƒ}Wqtk
r‰t|ƒ‚qXn|dk	r´||kr´t
|ƒ‚n|dk	rÛ||krÛt|ƒ‚n|S(s<
    A check that tests that a given value is a float
    (an integer will be accepted), and optionally - that it is between bounds.
    
    If the value is a string, then the conversion is done - if possible.
    Otherwise a VdtError is raised.
    
    This can accept negative values.
    
    >>> vtor.check('float', '2')
    2.0
    
    From now on we multiply the value to avoid comparing decimals
    
    >>> vtor.check('float', '-6.8') * 10
    -68.0
    >>> vtor.check('float', '12.2') * 10
    122.0
    >>> vtor.check('float', 8.4) * 10
    84.0
    >>> vtor.check('float', 'a')
    Traceback (most recent call last):
    VdtTypeError: the value "a" is of the wrong type.
    >>> vtor.check('float(10.1)', '10.2') * 10
    102.0
    >>> vtor.check('float(max=20.2)', '15.1') * 10
    151.0
    >>> vtor.check('float(10.0)', '9.0')
    Traceback (most recent call last):
    VdtValueTooSmallError: the value "9.0" is too small.
    >>> vtor.check('float(max=20.0)', '35.0')
    Traceback (most recent call last):
    VdtValueTooBigError: the value "35.0" is too big.
    R„R…R€(sminsmaxN(RƒtTrueR|RzR(R5R}RR$RFRR	(R0R„R…R†R‡((s,/usr/lib/python2.7/site-packages/validate.pyR*s#
tont1ttruetyestofft0tfalsetnocCstt|tƒrDyt|jƒSWqDtk
r@t|ƒ‚qDXn|tkrTtS|tkrdtSt|ƒ‚dS(sÞ
    Check if the value represents a boolean.
    
    >>> vtor.check('boolean', 0)
    0
    >>> vtor.check('boolean', False)
    0
    >>> vtor.check('boolean', '0')
    0
    >>> vtor.check('boolean', 'off')
    0
    >>> vtor.check('boolean', 'false')
    0
    >>> vtor.check('boolean', 'no')
    0
    >>> vtor.check('boolean', 'nO')
    0
    >>> vtor.check('boolean', 'NO')
    0
    >>> vtor.check('boolean', 1)
    1
    >>> vtor.check('boolean', True)
    1
    >>> vtor.check('boolean', '1')
    1
    >>> vtor.check('boolean', 'on')
    1
    >>> vtor.check('boolean', 'true')
    1
    >>> vtor.check('boolean', 'yes')
    1
    >>> vtor.check('boolean', 'Yes')
    1
    >>> vtor.check('boolean', 'YES')
    1
    >>> vtor.check('boolean', '')
    Traceback (most recent call last):
    VdtTypeError: the value "" is of the wrong type.
    >>> vtor.check('boolean', 'up')
    Traceback (most recent call last):
    VdtTypeError: the value "up" is of the wrong type.
    
    N(R|R}t	bool_dicttlowerRYRRyRˆ(R0((s,/usr/lib/python2.7/site-packages/validate.pyRds,
cCs\t|tƒst|ƒ‚n|jƒ}yt|ƒWntk
rWt|ƒ‚nX|S(ss
    Check that the supplied value is an Internet Protocol address, v.4,
    represented by a dotted-quad string, i.e. '1.2.3.4'.
    
    >>> vtor.check('ip_addr', '1 ')
    '1'
    >>> vtor.check('ip_addr', ' 1.2')
    '1.2'
    >>> vtor.check('ip_addr', ' 1.2.3 ')
    '1.2.3'
    >>> vtor.check('ip_addr', '1.2.3.4')
    '1.2.3.4'
    >>> vtor.check('ip_addr', '0.0.0.0')
    '0.0.0.0'
    >>> vtor.check('ip_addr', '255.255.255.255')
    '255.255.255.255'
    >>> vtor.check('ip_addr', '255.255.255.256')
    Traceback (most recent call last):
    VdtValueError: the value "255.255.255.256" is unacceptable.
    >>> vtor.check('ip_addr', '1.2.3.4.5')
    Traceback (most recent call last):
    VdtValueError: the value "1.2.3.4.5" is unacceptable.
    >>> vtor.check('ip_addr', 0)
    Traceback (most recent call last):
    VdtTypeError: the value "0" is of the wrong type.
    (R|R}RR"RR$R(R0((s,/usr/lib/python2.7/site-packages/validate.pyR s
cCsÁtd||fƒ\}}t|tƒr9t|ƒ‚nyt|ƒ}Wntk
rht|ƒ‚nX|dk	r||krt|ƒ‚n|dk	r·||kr·t|ƒ‚nt	|ƒS(sÈ
    Check that the value is a list of values.
    
    You can optionally specify the minimum and maximum number of members.
    
    It does no check on list members.
    
    >>> vtor.check('list', ())
    []
    >>> vtor.check('list', [])
    []
    >>> vtor.check('list', (1, 2))
    [1, 2]
    >>> vtor.check('list', [1, 2])
    [1, 2]
    >>> vtor.check('list(3)', (1, 2))
    Traceback (most recent call last):
    VdtValueTooShortError: the value "(1, 2)" is too short.
    >>> vtor.check('list(max=5)', (1, 2, 3, 4, 5, 6))
    Traceback (most recent call last):
    VdtValueTooLongError: the value "(1, 2, 3, 4, 5, 6)" is too long.
    >>> vtor.check('list(min=3, max=5)', (1, 2, 3, 4))
    [1, 2, 3, 4]
    >>> vtor.check('list', 0)
    Traceback (most recent call last):
    VdtTypeError: the value "0" is of the wrong type.
    >>> vtor.check('list', '12')
    Traceback (most recent call last):
    VdtTypeError: the value "12" is of the wrong type.
    R„R…(sminsmaxN(
RƒR|R}RRnt	TypeErrorRFR
RR9(R0R„R…tmin_lentmax_lentnum_members((s,/usr/lib/python2.7/site-packages/validate.pyRÅs
cCstt|||ƒƒS(sÍ
    Check that the value is a tuple of values.
    
    You can optionally specify the minimum and maximum number of members.
    
    It does no check on members.
    
    >>> vtor.check('tuple', ())
    ()
    >>> vtor.check('tuple', [])
    ()
    >>> vtor.check('tuple', (1, 2))
    (1, 2)
    >>> vtor.check('tuple', [1, 2])
    (1, 2)
    >>> vtor.check('tuple(3)', (1, 2))
    Traceback (most recent call last):
    VdtValueTooShortError: the value "(1, 2)" is too short.
    >>> vtor.check('tuple(max=5)', (1, 2, 3, 4, 5, 6))
    Traceback (most recent call last):
    VdtValueTooLongError: the value "(1, 2, 3, 4, 5, 6)" is too long.
    >>> vtor.check('tuple(min=3, max=5)', (1, 2, 3, 4))
    (1, 2, 3, 4)
    >>> vtor.check('tuple', 0)
    Traceback (most recent call last):
    VdtTypeError: the value "0" is of the wrong type.
    >>> vtor.check('tuple', '12')
    Traceback (most recent call last):
    VdtTypeError: the value "12" is of the wrong type.
    (R:R(R0R„R…((s,/usr/lib/python2.7/site-packages/validate.pyRòscCs»t|tƒst|ƒ‚ntd||fƒ\}}yt|ƒ}Wntk
rht|ƒ‚nX|dk	r||krt|ƒ‚n|dk	r·||kr·t|ƒ‚n|S(s¯
    Check that the supplied value is a string.
    
    You can optionally specify the minimum and maximum number of members.
    
    >>> vtor.check('string', '0')
    '0'
    >>> vtor.check('string', 0)
    Traceback (most recent call last):
    VdtTypeError: the value "0" is of the wrong type.
    >>> vtor.check('string(2)', '12')
    '12'
    >>> vtor.check('string(2)', '1')
    Traceback (most recent call last):
    VdtValueTooShortError: the value "1" is too short.
    >>> vtor.check('string(min=2, max=3)', '123')
    '123'
    >>> vtor.check('string(min=2, max=3)', '1234')
    Traceback (most recent call last):
    VdtValueTooLongError: the value "1234" is too long.
    R„R…(sminsmaxN(	R|R}RRƒRnR“RFR
R(R0R„R…R”R•R–((s,/usr/lib/python2.7/site-packages/validate.pyRs
cCs)gt|||ƒD]}t|ƒ^qS(s
    Check that the value is a list of integers.
    
    You can optionally specify the minimum and maximum number of members.
    
    Each list member is checked that it is an integer.
    
    >>> vtor.check('int_list', ())
    []
    >>> vtor.check('int_list', [])
    []
    >>> vtor.check('int_list', (1, 2))
    [1, 2]
    >>> vtor.check('int_list', [1, 2])
    [1, 2]
    >>> vtor.check('int_list', [1, 'a'])
    Traceback (most recent call last):
    VdtTypeError: the value "a" is of the wrong type.
    (RR(R0R„R…tmem((s,/usr/lib/python2.7/site-packages/validate.pyR8scCs)gt|||ƒD]}t|ƒ^qS(sl
    Check that the value is a list of booleans.
    
    You can optionally specify the minimum and maximum number of members.
    
    Each list member is checked that it is a boolean.
    
    >>> vtor.check('bool_list', ())
    []
    >>> vtor.check('bool_list', [])
    []
    >>> check_res = vtor.check('bool_list', (True, False))
    >>> check_res == [True, False]
    1
    >>> check_res = vtor.check('bool_list', [True, False])
    >>> check_res == [True, False]
    1
    >>> vtor.check('bool_list', [True, 'a'])
    Traceback (most recent call last):
    VdtTypeError: the value "a" is of the wrong type.
    (RR(R0R„R…R—((s,/usr/lib/python2.7/site-packages/validate.pyROscCs)gt|||ƒD]}t|ƒ^qS(s
    Check that the value is a list of floats.
    
    You can optionally specify the minimum and maximum number of members.
    
    Each list member is checked that it is a float.
    
    >>> vtor.check('float_list', ())
    []
    >>> vtor.check('float_list', [])
    []
    >>> vtor.check('float_list', (1, 2.0))
    [1.0, 2.0]
    >>> vtor.check('float_list', [1, 2.0])
    [1.0, 2.0]
    >>> vtor.check('float_list', [1, 'a'])
    Traceback (most recent call last):
    VdtTypeError: the value "a" is of the wrong type.
    (RR(R0R„R…R—((s,/usr/lib/python2.7/site-packages/validate.pyRhscCsGt|tƒrt|ƒ‚ngt|||ƒD]}t|ƒ^q1S(sn
    Check that the value is a list of strings.
    
    You can optionally specify the minimum and maximum number of members.
    
    Each list member is checked that it is a string.
    
    >>> vtor.check('string_list', ())
    []
    >>> vtor.check('string_list', [])
    []
    >>> vtor.check('string_list', ('a', 'b'))
    ['a', 'b']
    >>> vtor.check('string_list', ['a', 1])
    Traceback (most recent call last):
    VdtTypeError: the value "1" is of the wrong type.
    >>> vtor.check('string_list', 'hello')
    Traceback (most recent call last):
    VdtTypeError: the value "hello" is of the wrong type.
    (R|R}RRR(R0R„R…R—((s,/usr/lib/python2.7/site-packages/validate.pyRscCs)gt|||ƒD]}t|ƒ^qS(s
    Check that the value is a list of IP addresses.
    
    You can optionally specify the minimum and maximum number of members.
    
    Each list member is checked that it is an IP address.
    
    >>> vtor.check('ip_addr_list', ())
    []
    >>> vtor.check('ip_addr_list', [])
    []
    >>> vtor.check('ip_addr_list', ('1.2.3.4', '5.6.7.8'))
    ['1.2.3.4', '5.6.7.8']
    >>> vtor.check('ip_addr_list', ['a'])
    Traceback (most recent call last):
    VdtValueError: the value "a" is unacceptable.
    (RR(R0R„R…R—((s,/usr/lib/python2.7/site-packages/validate.pyR™scCs1t|ttfƒs!|g}nt|||ƒS(sé
    Check that a value is a list, coercing strings into
    a list with one member. Useful where users forget the
    trailing comma that turns a single value into a list.
    
    You can optionally specify the minimum and maximum number of members.
    A minumum of greater than one will fail if the user only supplies a
    string.
    
    >>> vtor.check('force_list', ())
    []
    >>> vtor.check('force_list', [])
    []
    >>> vtor.check('force_list', 'hello')
    ['hello']
    (R|R9R:R(R0R„R…((s,/usr/lib/python2.7/site-packages/validate.pyRC®sR4R5R7R8R6cGsÏyt|ƒ}Wntk
r/t|ƒ‚nX|t|ƒkrQt|ƒ‚n!|t|ƒkrrt|ƒ‚ny4gt||ƒD]\}}t||ƒ^q…SWn"tk
rÊ}td|ƒ‚nXdS(sÛ
    Check that the value is a list.
    Allow specifying the type of each member.
    Work on lists of specific lengths.
    
    You specify each member as a positional argument specifying type
    
    Each type should be one of the following strings :
      'integer', 'float', 'ip_addr', 'string', 'boolean'
    
    So you can specify a list of two strings, followed by
    two integers as :
    
      mixed_list('string', 'string', 'integer', 'integer')
    
    The length of the list must match the number of positional
    arguments you supply.
    
    >>> mix_str = "mixed_list('integer', 'float', 'ip_addr', 'string', 'boolean')"
    >>> check_res = vtor.check(mix_str, (1, 2.0, '1.2.3.4', 'a', True))
    >>> check_res == [1, 2.0, '1.2.3.4', 'a', True]
    1
    >>> check_res = vtor.check(mix_str, ('1', '2.0', '1.2.3.4', 'a', 'True'))
    >>> check_res == [1, 2.0, '1.2.3.4', 'a', True]
    1
    >>> vtor.check(mix_str, ('b', 2.0, '1.2.3.4', 'a', True))
    Traceback (most recent call last):
    VdtTypeError: the value "b" is of the wrong type.
    >>> vtor.check(mix_str, (1, 2.0, '1.2.3.4', 'a'))
    Traceback (most recent call last):
    VdtValueTooShortError: the value "(1, 2.0, '1.2.3.4', 'a')" is too short.
    >>> vtor.check(mix_str, (1, 2.0, '1.2.3.4', 'a', 1, 'b'))
    Traceback (most recent call last):
    VdtValueTooLongError: the value "(1, 2.0, '1.2.3.4', 'a', 1, 'b')" is too long.
    >>> vtor.check(mix_str, 0)
    Traceback (most recent call last):
    VdtTypeError: the value "0" is of the wrong type.
    
    This test requires an elaborate setup, because of a change in error string
    output from the interpreter between Python 2.2 and 2.3 .
    
    >>> res_seq = (
    ...     'passed an incorrect value "',
    ...     'yoda',
    ...     '" for parameter "mixed_list".',
    ... )
    >>> res_str = "'".join(res_seq)
    >>> try:
    ...     vtor.check('mixed_list("yoda")', ('a'))
    ... except VdtParamError, err:
    ...     str(err) == res_str
    1
    R@N(	RnR“RR
RR{tfun_dictRYR(R0RqtlengthRiRR‚((s,/usr/lib/python2.7/site-packages/validate.pyRÎs6
4cGs=t|tƒst|ƒ‚n||kr9t|ƒ‚n|S(s£
    This check matches the value to any of a set of options.
    
    >>> vtor.check('option("yoda", "jedi")', 'yoda')
    'yoda'
    >>> vtor.check('option("yoda", "jedi")', 'jed')
    Traceback (most recent call last):
    VdtValueError: the value "jed" is unacceptable.
    >>> vtor.check('option("yoda", "jedi")', 0)
    Traceback (most recent call last):
    VdtTypeError: the value "0" is of the wrong type.
    (R|R}RR(R0toptions((s,/usr/lib/python2.7/site-packages/validate.pyRs

cOs
|||fS(s

    A function that exists for test purposes.
    
    >>> checks = [
    ...     '3, 6, min=1, max=3, test=list(a, b, c)',
    ...     '3',
    ...     '3, 6',
    ...     '3,',
    ...     'min=1, test="a b c"',
    ...     'min=5, test="a, b, c"',
    ...     'min=1, max=3, test="a, b, c"',
    ...     'min=-100, test=-99',
    ...     'min=1, max=3',
    ...     '3, 6, test="36"',
    ...     '3, 6, test="a, b, c"',
    ...     '3, max=3, test=list("a", "b", "c")',
    ...     '''3, max=3, test=list("'a'", 'b', "x=(c)")''',
    ...     "test='x=fish(3)'",
    ...    ]
    >>> v = Validator({'test': _test})
    >>> for entry in checks:
    ...     print v.check(('test(%s)' % entry), 3)
    (3, ('3', '6'), {'test': ['a', 'b', 'c'], 'max': '3', 'min': '1'})
    (3, ('3',), {})
    (3, ('3', '6'), {})
    (3, ('3',), {})
    (3, (), {'test': 'a b c', 'min': '1'})
    (3, (), {'test': 'a, b, c', 'min': '5'})
    (3, (), {'test': 'a, b, c', 'max': '3', 'min': '1'})
    (3, (), {'test': '-99', 'min': '-100'})
    (3, (), {'max': '3', 'min': '1'})
    (3, ('3', '6'), {'test': '36'})
    (3, ('3', '6'), {'test': 'a, b, c'})
    (3, ('3',), {'test': ['a', 'b', 'c'], 'max': '3'})
    (3, ('3',), {'test': ["'a'", 'b', 'x=(c)'], 'max': '3'})
    (3, (), {'test': 'x=fish(3)'})
    
    >>> v = Validator()
    >>> v.check('integer(default=6)', '3')
    3
    >>> v.check('integer(default=6)', None, True)
    6
    >>> v.get_default_value('integer(default=6)')
    6
    >>> v.get_default_value('float(default=6)')
    6.0
    >>> v.get_default_value('pass(default=None)')
    >>> v.get_default_value("string(default='None')")
    'None'
    >>> v.get_default_value('pass')
    Traceback (most recent call last):
    KeyError: 'Check "pass" has no default value.'
    >>> v.get_default_value('pass(default=list(1, 2, 3, 4))')
    ['1', '2', '3', '4']
    
    >>> v = Validator()
    >>> v.check("pass(default=None)", None, True)
    >>> v.check("pass(default='None')", None, True)
    'None'
    >>> v.check('pass(default="None")', None, True)
    'None'
    >>> v.check('pass(default=list(1, 2, 3, 4))', None, True)
    ['1', '2', '3', '4']
    
    Bug test for unicode arguments
    >>> v = Validator()
    >>> v.check(u'string(min=4)', u'test')
    u'test'
    
    >>> v = Validator()
    >>> v.get_default_value(u'string(min=4, default="1234")')
    u'1234'
    >>> v.check(u'string(min=4, default="1234")', u'test')
    u'test'
    
    >>> v = Validator()
    >>> default = v.get_default_value('string(default=None)')
    >>> default == None
    1
    ((R0Rqtkeywargs((s,/usr/lib/python2.7/site-packages/validate.pyt_test&sQcCsdS(s¯
    >>> 
    >>> v = Validator()
    >>> v.get_default_value('string(default="#ff00dd")')
    '#ff00dd'
    >>> v.get_default_value('integer(default=3) # comment')
    3
    N((((s,/usr/lib/python2.7/site-packages/validate.pyt_test2zscCsdS(s’
    >>> vtor.check('string(default="")', '', missing=True)
    ''
    >>> vtor.check('string(default="\n")', '', missing=True)
    '\n'
    >>> print vtor.check('string(default="\n")', '', missing=True),
    <BLANKLINE>
    >>> vtor.check('string()', '\n')
    '\n'
    >>> vtor.check('string(default="\n\n\n")', '', missing=True)
    '\n\n\n'
    >>> vtor.check('string()', 'random \n text goes here\n\n')
    'random \n text goes here\n\n'
    >>> vtor.check('string(default=" \nrandom text\ngoes \n here\n\n ")',
    ... '', missing=True)
    ' \nrandom text\ngoes \n here\n\n '
    >>> vtor.check("string(default='\n\n\n')", '', missing=True)
    '\n\n\n'
    >>> vtor.check("option('\n','a','b',default='\n')", '', missing=True)
    '\n'
    >>> vtor.check("string_list()", ['foo', '\n', 'bar'])
    ['foo', '\n', 'bar']
    >>> vtor.check("string_list(default=list('\n'))", '', missing=True)
    ['\n']
    N((((s,/usr/lib/python2.7/site-packages/validate.pyt_test3„st__main__tvtortglobs(@R-Rt__all__RsRtRwRuRaRoRvRxRt	NameErrorRRt	ExceptionRRRR1RRRRR	R
RtobjectR
RyRƒRFRRRˆR‘RRRRRRRRRRRCR˜RRRœRRžR+tsystdoctesttmodulestgettmt__dict__tcopyR¡RGttestmod(((s,/usr/lib/python2.7/site-packages/validate.pyt<module>s´		)


	"	#ÿ%84#&	<	%-"$
	D		T	
		

OHA YOOOO