⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.144
Server IP:
157.245.143.252
Server:
Linux www 6.11.0-9-generic #9-Ubuntu SMP PREEMPT_DYNAMIC Mon Oct 14 13:19:59 UTC 2024 x86_64
Server Software:
nginx/1.26.0
PHP Version:
8.3.11
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
lib
/
python3
/
dist-packages
/
configobj
/
__pycache__
/
View File Name :
validate.cpython-312.pyc
:e) d Z dZdZddlZddlZddlmZ ej dej ej z Z ej dej ej z Z dZ d e z Z d Z d Z G d d e Z G d de Z G d de Z G d de Z G d de Z G d de Z G d de Z G d de Z G d d e Z G d d e Z G d d!e Z d=d#Z d>d$Z d>d%Z d&d&d&d&d&d"d"d"d"d"d' Z d( Z!d) Z"d>d*Z#d>d+Z$d>d,Z%d>d-Z&d>d.Z'd>d/Z(d>d0Z)d>d1Z*d>d2Z+e e e"e%e!d3Z,d4 Z-d5 Z.d6 Z/d7 Z0d8 Z1e2d9k( rddlZddl3Z3ejh jk d9 Z6e6jn jq Z9e9ju d: e i e3jv e6e9e3jx e3jz z ; \ Z>Z?e>rJ d<j e>e? yy)?a 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``. z1.0.1) __version__dottedQuadToNumnumToDottedQuad ValidateErrorVdtUnknownCheckError VdtParamError VdtTypeError VdtValueErrorVdtValueTooSmallErrorVdtValueTooBigErrorVdtValueTooShortErrorVdtValueTooLongErrorVdtMissingValue Validator is_integeris_float is_booleanis_listis_tuple is_ip_addr is_string is_int_list is_bool_list is_float_listis_string_listis_ip_addr_list is_mixed_list is_option N)pprinta (?: ([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 ) \) ) z ( (?:".*?")| # double quotes (?:'.*?')| # single quotes (?:[^'",\s=][^,=]*?) # unquoted ) (?: (?:\s*,\s*)|(?:\s*$) # comma ) a (?: ( (?: [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 ) ) z^%s*c ddl }ddl} |j d|j | j d S # |j $ r t d| z w xY w)a 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') 4294967295 >>> dottedQuadToNum('255.255.255.256') Traceback (most recent call last): ValueError: Not a good dotted-quad IP: 255.255.255.256 r N!Lz Not a good dotted-quad IP: %s)socketstructunpack inet_atonstriperror ValueError)ipr" r# s 4/usr/lib/python3/dist-packages/configobj/validate.pyr r s_ ( ?}}T RXXZ (**+- - << ?82=>>?s 1< Ac ddl }ddl}| t d kD s| dk rt d| z |j |j dt | S # |j |j t f$ r t d| z w xY w)a Convert int or long int to dotted quad string >>> numToDottedQuad(int(-1)) Traceback (most recent call last): ValueError: Not a good numeric IP: -1 >>> numToDottedQuad(int(1)) '0.0.0.1' >>> numToDottedQuad(int(16777218)) '1.0.0.2' >>> numToDottedQuad(int(16908291)) '1.2.0.3' >>> numToDottedQuad(int(16909060)) '1.2.3.4' >>> numToDottedQuad(int(4294967295)) '255.255.255.255' >>> numToDottedQuad(int(4294967296)) Traceback (most recent call last): ValueError: Not a good numeric IP: 4294967296 >>> numToDottedQuad(-1) Traceback (most recent call last): ValueError: Not a good numeric IP: -1 >>> numToDottedQuad(1) '0.0.0.1' >>> numToDottedQuad(16777218) '1.0.0.2' >>> numToDottedQuad(16908291) '1.2.0.3' >>> numToDottedQuad(16909060) '1.2.3.4' >>> numToDottedQuad(4294967295) '255.255.255.255' >>> numToDottedQuad(4294967296) Traceback (most recent call last): ValueError: Not a good numeric IP: 4294967296 r Nl zNot a good numeric IP: %sr! )r" r# intr( inet_ntoapackr' OverflowError)numr" r# s r* r r s P S_ a4s:;;< KKc#h ') ) LL&,, 6 <4s:;;<s )A /Bc e Zd ZdZy)r a 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 N__name__ __module__ __qualname____doc__ r* r r I s r8 r c e Zd ZdZy)r z1No value was supplied to a check that needed one.Nr2 r7 r8 r* r r W s ;r8 r c e Zd ZdZd Zy)r z'An unknown check function was requestedc 8 t j | d|d y)z >>> raise VdtUnknownCheckError('yoda') Traceback (most recent call last): VdtUnknownCheckError: the check "yoda" is unknown. z the check "z " is unknown.Nr __init__selfvalues r* r= z VdtUnknownCheckError.__init__^ tU%LMr8 Nr3 r4 r5 r6 r= r7 r8 r* r r [ s 1Nr8 r c e Zd ZdZd Zy)r z!An incorrect parameter was passedc > t j | d|d|d y)z >>> raise VdtParamError('yoda', 'jedi') Traceback (most recent call last): VdtParamError: passed an incorrect value "jedi" for parameter "yoda". zpassed an incorrect value "z" for parameter "z".N) SyntaxErrorr= )r? namer@ s r* r= zVdtParamError.__init__j s T[`bf#ghr8 NrB r7 r8 r* r r g s +ir8 r c e Zd ZdZd Zy)r z(The value supplied was of the wrong typec 8 t j | d|d y)z >>> raise VdtTypeError('jedi') Traceback (most recent call last): VdtTypeError: the value "jedi" is of the wrong type. the value "z" is of the wrong type.Nr< r> s r* r= zVdtTypeError.__init__v s tu%VWr8 NrB r7 r8 r* r r s s 2Xr8 r c e Zd ZdZd Zy)r zIThe value supplied was of the correct type, but was not an allowed value.c 8 t j | d|d y)z >>> raise VdtValueError('jedi') Traceback (most recent call last): VdtValueError: the value "jedi" is unacceptable. rI z" is unacceptable.Nr< r> s r* r= zVdtValueError.__init__ s t%%QRr8 NrB r7 r8 r* r r s SSr8 r c e Zd ZdZd Zy)r z>The value supplied was of the correct type, but was too small.c 8 t j | d|d y)z >>> raise VdtValueTooSmallError('0') Traceback (most recent call last): VdtValueTooSmallError: the value "0" is too small. rI z" is too small.Nr< r> s r* r= z VdtValueTooSmallError.__init__ s tu%NOr8 NrB r7 r8 r* r r s HPr8 r c e Zd ZdZd Zy)r z<The value supplied was of the correct type, but was too big.c 8 t j | d|d y)z >>> raise VdtValueTooBigError('1') Traceback (most recent call last): VdtValueTooBigError: the value "1" is too big. rI z " is too big.Nr< r> s r* r= z VdtValueTooBigError.__init__ rA r8 NrB r7 r8 r* r r s FNr8 r c e Zd ZdZd Zy)r z>The value supplied was of the correct type, but was too short.c 8 t j | d|d y)z >>> raise VdtValueTooShortError('jed') Traceback (most recent call last): VdtValueTooShortError: the value "jed" is too short. rI z" is too short.Nr< r> s r* r= z VdtValueTooShortError.__init__ s .3 5 7r8 NrB r7 r8 r* r r s H7r8 r c e Zd ZdZd Zy)r z=The value supplied was of the correct type, but was too long.c 8 t j | d|d y)z >>> raise VdtValueTooLongError('jedie') Traceback (most recent call last): VdtValueTooLongError: the value "jedie" is too long. rI z" is too long.Nr< r> s r* r= z VdtValueTooLongError.__init__ s te%MNr8 NrB r7 r8 r* r r s GOr8 r c t e Zd ZdZ ej dej Z ej dej Ze Z e Z ej e ej ej z Z ej eej ej z ZddZddZd Zd Zd Zd Zd Zd Zd Zd Zy)r a 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, str)): ... raise VdtTypeError(value) ... elif isinstance(value, str): ... # 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: https://configobj.readthedocs.org/en/latest/configobj.html z([^\(\)]+?)\((.*)\)z%^([a-zA-Z_][a-zA-Z0-9_]*)\s*=\s*(.*)$Nc v i d| j dt dt dt dt dt dt dt d t d t d t d t d t dt d| j dt dt | _ || j j# | t$ | _ i | _ y)z( >>> vtri = Validator() integerfloatbooleanip_addrstringlisttupleint_list float_list bool_list ip_addr_list string_list mixed_listpassoption force_listN)_passr r r r r r r r r r r r r r rf functionsupdater baseErrorClass_cache)r? rh s r* r= zValidator.__init__ s z X z z i G X - O > - DJJ i! " *# & NN ! !) , + r8 c | j | \ }}}}|r | t | j | }|y| j |||| S )a 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)_parse_with_cachingr _handle_none _check_value)r? checkr@ missingfun_namefun_args fun_kwargsdefaults r* rp zValidator.check6 s] * 372J2J52Q/(J %''%%g.E = (JGGr8 c < |dk( ry |dv r| j | }|S )NNonez'None'z"None")_unquoter> s r* rn zValidator._handle_noneY s( F? * *MM%(E r8 c || j v r+| j | \ }}}}t | }t | }n{| j | \ }}}}t t |j D cg c] \ }}t | |f c}} }|t | t | |f| j |< ||||fS c c}}w N)rk r\ dict _parse_checkitemsstr)r? rp rr rs rt ru keyr@ s r* rm z Validator._parse_with_cachingb s DKK 6:kk%6H 3Hh G H~H j)J6:6G6G6N 3Hh G T*JZJZJ\E] ^E]\c5C% 0E] ^_J!)4>4 ;KW!TDKK :w66 _s 1B; c j | j | } ||g|i |S # t $ r t | w xY wr{ )rh KeyErrorr )r? r@ rr rs rt funs r* ro zValidator._check_valuep sH 7..*C u6x6:6 6 1&x0 0 1s 2c | j j | }|r1|j d }|j d }| j j | }|t d|z g }i }| j j | D ] }|j }| j j | } | r| j | \ } } | || < J| j j | } | r;| j d } | dvr| j | } | || j d < |j | j | n|di d fS |j dd } |||| fS )N zBad syntax in check "%s".rx r7 ru )_func_rematchgroup _matchfinderr _paramfinderfindallr& _list_arg _list_handle_key_argry appendpop)r? rp fun_matchrr arg_string arg_matchrs rt arg listmatchr valkeymatchru s r* r} zValidator._parse_checky sb MM''. q)H" +J ))// ;I #$?%$GHHHJ((00<iik NN 0 0 5 # 0 0 ;HC&)JsO ==..s3"..+C "66 "mmC 047Jx~~a 01 c 23# =( "b$& & ..D1:w66r8 c P t | dk\ r|d dv r|d |d k( r|dd }|S )z Unquote a value if necessary.r r )'"r )len)r? r s r* ry zValidator._unquote s7 HMA* 43q6SW;La)C r8 c g }|j d }|j d }| j j | D ]" }|j | j | $ ||fS )z7Take apart a ``keyword=list('val, 'val')`` type string.r r )r _list_membersr r ry )r? r outrF argsr s r* r zValidator._list_handle s] q!q!%%--d3C JJt}}S) * 4Syr8 c |S )z Dummy check that always passes >>> vtor.check('', 0) 0 >>> vtor.check('', '0') '0' r7 r> s r* rg zValidator._pass s r8 c | j | \ }}}}|t d|z | j | }||S | j |||| S )z 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. z Check "%s" has no default value.)rm r rn ro )r? rp rr rs rt ru r@ s r* get_default_valuezValidator.get_default_value sd 372J2J52Q/(J ?=EF F!!'* =L (JGGr8 r{ F)r3 r4 r5 r6 recompileDOTALLr r r r _paramstringVERBOSEr _matchstringr r= rp rn rm ro r} ry r rg r r7 r8 r* r r s EP rzz0"))<H rzzBRYYOH I "M 2::lBJJ,BCL 2::lBJJ,BCL< HF 7 7%7P Hr8 r Fc 6 |xr t xs t }g }t | | D ]X \ }}||j | t |t t t f r |j || Nt || |S # t $ r}t || d}~ww xY w)a 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)rX r, zipr isinstancer r( r )namesvaluesto_floatr out_paramsrF r es r* _is_num_paramr s u #CJ5&) s ; c " c5# . / /!!#c(+ c* * * /#D#.. /s A>> B BBc t d||f \ }}t | t t f s t | t | t r t | } || |k r t | || |kD r t | | S # t $ r t | w xY w)a? A check that tests that a given value is an integer (int) 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 minmax)r r r, r r r( r r r@ r r min_valmax_vals r* r r s P '~SzBWg ec3Z (5!!% &JE %'/#E**%'/!%(( L & u% % &s A5 5B c ( t d||fd \ }}t | t t t f s t | t | t s t | } || |k r t | || |kD r t | | S # t $ r t | w xY w)a< 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 T)r ) r r r, rX r r r( r r r s r* r r , s F 'c T3Wg ec5# . /5!! eU # &%LE %'/#E**%'/!%(( L & u% % &s A< <BT) Ton1trueyesFoff0falsenoc t | t r t | j S | dk( ry| dk( ryt | # t $ r t | w xY w)a 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. FT)r r bool_dictlowerr r r@ s r* r r f sb X % & U[[]+ + ~ $ 5!! & u% % &s A Ac t | t s t | | j } t | | S # t $ r t | w xY w)as 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 r r& r r( r r s r* r r sT 6 eS !5!! KKME# L #E""#s : Ac t d||f \ }}t | t r t | t | }|||k r t | |||kD r t | t | S # t $ r t | w xY w)a 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 r r r r TypeErrorr r r\ r@ r r min_lenmax_len num_memberss r* r r s > '~SzBWg% 5!!"%j {W 4#E**{W 4"5)) ; "5!!"s A( (A=c . t t | || S )a 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 r@ r r s r* r r s > S) **r8 c t | t s t | t d||f \ }} t | }|||k r t | |||kD r t | | S # t $ r t | w xY w)a 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 r r r r r r r r s r* r r s , eS !5!!&~SzBWg"%j {W 4#E**{W 4"5)) L "5!!"s A A4c T t | || D cg c] }t | c}S c c}w )a 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. )r r r@ r r mems r* r r : s+ ( (/uc3'? @'?JsO'? @@ @ %c T t | || D cg c] }t | c}S c c}w )al 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. )r r r s r* r r Q s+ , (/uc3'? @'?JsO'? @@ @r c T t | || D cg c] }t | c}S c c}w )a 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. )r r r s r* r r j s+ ( &-UC%= >%=cHSM%= >> >r c t | t r t | t | || D cg c] }t | c}S c c}w )an 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 r r r r s r* r r s@ * % 5!!&-eS#&> ?&>sIcN&> ?? ?s A c T t | || D cg c] }t | c}S c c}w )a 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. )r r r s r* r r s+ $ (/uc3'? @'?JsO'? @@ @r c N t | t t f s| g} t | || S )a 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 r\ r] r r s r* rf rf s( " edE] + 5#s ##r8 )rW rX rZ r[ rY c L t | }|t | k r t | |t | kD r t | t || D cg c] \ }}t | | c}}S # t $ r t | w xY wc c}}w # t $ r}t d| d}~ww xY w)a 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. >>> vtor.check('mixed_list("yoda")', ('a')) Traceback (most recent call last): VdtParamError: passed an incorrect value "KeyError('yoda',)" for parameter "'mixed_list'" rc N) r r r r r r fun_dictr r )r@ r lengthr r r s r* r r s V"U D #E** #d) "5))-36tU3CD3CxsC c"3CDD "5!!" E -L!,,-s5 A+ B B'B +B B B# B B#c Z t | t s t | | |vr t | | S )a 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 r r )r@ optionss r* r r s1 eS !5!! G E"" Lr8 c | ||fS )a 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: ... pprint(v.check(('test(%s)' % entry), 3)) (3, ('3', '6'), {'max': '3', 'min': '1', 'test': ['a', 'b', 'c']}) (3, ('3',), {}) (3, ('3', '6'), {}) (3, ('3',), {}) (3, (), {'min': '1', 'test': 'a b c'}) (3, (), {'min': '5', 'test': 'a, b, c'}) (3, (), {'max': '3', 'min': '1', 'test': 'a, b, c'}) (3, (), {'min': '-100', 'test': '-99'}) (3, (), {'max': '3', 'min': '1'}) (3, ('3', '6'), {'test': '36'}) (3, ('3', '6'), {'test': 'a, b, c'}) (3, ('3',), {'max': '3', 'test': ['a', 'b', 'c']}) (3, ('3',), {'max': '3', 'test': ["'a'", 'b', 'x=(c)']}) (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('string(min=4)', 'test') == 'test' True >>> v = Validator() >>> v.get_default_value('string(min=4, default="1234")') == '1234' True >>> v.check('string(min=4, default="1234")'), 'test') == 'test' True >>> v = Validator() >>> default = v.get_default_value('string(default=None)') >>> default == None 1 r7 )r@ r keywargss r* _testr s b 4 ""r8 c y)z >>> >>> v = Validator() >>> v.get_default_value('string(default="#ff00dd")') '#ff00dd' >>> v.get_default_value('integer(default=3) # comment') 3 Nr7 r7 r8 r* _test2r q r8 c y)a >>> vtor.check('string(default="")', '', missing=True) '' >>> vtor.check('string(default="\n")', '', missing=True) '\n' >>> print(vtor.check('string(default="\n")', '', missing=True)) <BLANKLINE> <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'] Nr7 r7 r8 r* _test3r { r r8 __main__vtor)globs optionflagsz{} failures out of {} testsr )NN)Ar6 r __all__r sysr r r r r r r r r r Exceptionr r r rE r r r r r r r objectr r r r r r r r r r r r r r r rf r r r r r r r3 doctestmodulesgetm__dict__copyr ri testmodIGNORE_EXCEPTION_DETAILELLIPSISfailurestestsformatr7 r8 r* <module>r sq "n` @ BJJ * ZZ"))+ . ZZ")) ' R $ <1<h I <m < N= N iK i X= X SM S PM P N- N 7M 7 O= OOH OHd J5p1j dtD UU% 9"x"J*Z +D!HA.A2?.@4A*$0 6-r(Q#h: z #A JJOO E LL &goo 33g6F6FFHOHe N6==hNN<x r8