/usr/lib/python2.6/site-packages/configobj.pyc (66412B)
v, remove specified key and return the corresponding value. If key is not found, d is returned if given, otherwise KeyError is raised' ( R t popR R R R R R R. R] R R ( RG R{ R R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR s c C sL | i | i } | p t d n | d } | | } | | =| | f S( s Pops the first (key,val)s" : 'popitem(): dictionary is empty'i ( R R R ( RG t sequenceR{ R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt popitem s c C s> t i | g | _ g | _ h | _ h | _ d | _ d S( s A version of clear that also affects scalars/sections Also clears comments and configspec. Leaves other attributes alone : depth/main/parent are not affected N( R t clearR R R R R: R3 ( RG ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR s c C s5 y | | SWn" t j o | | | <| | SXd S( s: A version of setdefault that sets sequence if appropriate.N( R ( RG R{ R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt setdefault s c C s t | i | i | i S( s8 D.items() -> list of D's (key, value) pairs, as 2-tuples( t zipR R t values( RG ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt items s c C s | i | i S( s D.keys() -> list of D's keys( R R ( RG ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt keys s c C s- g } | i | i D] } | | | q ~ S( s D.values() -> list of D's values( R R ( RG t _[1]R{ ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR s c C s t | i S( s= D.iteritems() -> an iterator over the (key, value) items of D( RO R ( RG ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR s c C s t | i | i S( s. D.iterkeys() -> an iterator over the keys of D( RO R R ( RG ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt iterkeys s c C s t | i S( s2 D.itervalues() -> an iterator over the values of D( RO R ( RG ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt itervalues s c C sP d d i g } | i | i D]' } | d t | t | | f q ~ S( s x.__repr__() <==> repr(x)s {%s}s , s %s: %s( Ry R R t repr( RG R R{ ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt __repr__ s s x.__str__() <==> str(x)c C s h } x | D]z } | | } t | t o | i } nA t | t o t | } n! t | t o t | } n | | |>> n = a.dict() >>> n == a 1 >>> n is a 0 ( R] R R R RT ( RG t newdictR t this_entry( ( s- /usr/lib/python2.6/site-packages/configobj.pyR s c C sq xj | i D]\ \ } } | | j o9 t | | t o% t | t o | | i | q | | |>> a = '''[section1] ... option1 = True ... [[subsection]] ... more_options = False ... # end of file'''.splitlines() >>> b = '''# File is user.ini ... [section1] ... option1 = False ... # end of file'''.splitlines() >>> c1 = ConfigObj(b) >>> c2 = ConfigObj(a) >>> c2.merge(c1) >>> c2 ConfigObj({'section1': {'option1': 'False', 'subsection': {'more_options': 'False'}}}) N( R R] R t merge( RG R R{ R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR ! s !c C s | | i j o | i } n. | | i j o | i } n t d | | i | } | | } t i | | t i | | | | i | | i | | | i | } | i | } | i | =| i | =| | i | <| | i |>> config = '''[XXXXsection] ... XXXXkey = XXXXvalue'''.splitlines() >>> cfg = ConfigObj(config) >>> cfg ConfigObj({'XXXXsection': {'XXXXkey': 'XXXXvalue'}}) >>> def transform(section, key): ... val = section[key] ... newkey = key.replace('XXXX', 'CLIENT1') ... section.rename(key, newkey) ... if isinstance(val, (tuple, list, dict)): ... pass ... else: ... val = val.replace('XXXX', 'CLIENT1') ... section[newkey] = val >>> cfg.walk(transform, call_on_sections=True) {'CLIENT1section': {'CLIENT1key': None}} >>> cfg ConfigObj({'CLIENT1section': {'CLIENT1key': 'CLIENT1value'}}) R/ t call_on_sections( t rangeRz R t ExceptionRW R t walk( RG t functionR/ R t keywargst outR R R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR Z s> / c C s | | } | t j o t S| t j o t Sy5 t | t p t n | i i | i SWn# t j o t d | n Xd S( s_ Accepts a key as input. The corresponding value must be a string or the objects (``True`` or 1) or (``False`` or 0). We allow 0 and 1 to retain compatibility with Python 2.2. If the string is one of ``True``, ``On``, ``Yes``, or ``1`` it returns ``True``. If the string is one of ``False``, ``Off``, ``No``, or ``0`` it returns ``False``. ``as_bool`` is not case sensitive. Any other input will raise a ``ValueError``. >>> a = ConfigObj() >>> a['a'] = 'fish' >>> a.as_bool('a') Traceback (most recent call last): ValueError: Value "fish" is neither True nor False >>> a['b'] = 'True' >>> a.as_bool('b') 1 >>> a['b'] = 'off' >>> a.as_bool('b') 0 s$ Value "%s" is neither True nor FalseN( RV RW R] R R R t _boolsR R ( RG R{ R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt as_bool s c C s t | | S( si A convenience method which coerces the specified value to an integer. If the value is an invalid literal for ``int``, a ``ValueError`` will be raised. >>> a = ConfigObj() >>> a['a'] = 'fish' >>> a.as_int('a') Traceback (most recent call last): ValueError: invalid literal for int() with base 10: 'fish' >>> a['b'] = '1' >>> a.as_int('b') 1 >>> a['b'] = '3.2' >>> a.as_int('b') Traceback (most recent call last): ValueError: invalid literal for int() with base 10: '3.2' ( t int( RG R{ ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt as_int s c C s t | | S( s A convenience method which coerces the specified value to a float. If the value is an invalid literal for ``float``, a ``ValueError`` will be raised. >>> a = ConfigObj() >>> a['a'] = 'fish' >>> a.as_float('a') Traceback (most recent call last): ValueError: invalid literal for float(): fish >>> a['b'] = '1' >>> a.as_float('b') 1.0 >>> a['b'] = '3.2' >>> a.as_float('b') 3.2000000000000002 ( R[ ( RG R{ ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt as_float s c C s2 | | } t | t t f o t | S| g S( sU A convenience method which fetches the specified value, guaranteeing that it is a list. >>> a = ConfigObj() >>> a['a'] = 1 >>> a.as_list('a') [1] >>> a['a'] = (1,) >>> a.as_list('a') [1] >>> a['a'] = [1] >>> a.as_list('a') [1] ( R] RT R ( RG R{ t result( ( s- /usr/lib/python2.6/site-packages/configobj.pyt as_list s c C sH | i | } t i | | | | | i j o | i i | n | S( s Restore (and return) default value for the specified key. This method will only work for a ConfigObj that was created with a configspec and has been validated. If there is no default value for this key, ``KeyError`` is raised. ( R R R R R ( RG R{ R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt restore_default s c C sG x | i D] } | i | q Wx | i D] } | | i q+ Wd S( s' Recursively restore default values to all members that have them. This method will only work for a ConfigObj that was created with a configspec and has been validated. It doesn't delete or modify entries without default values. N( R R R t restore_defaults( RG R{ Rs ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR . s N(' RA RB Ro R R R: Rm R R R RW R R R R R R R R R R R R R t __iter__R R t __str__R R R RV R R R R R R R ( ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR sH ; T , c B s" e Z d Z e i d e i Z e i d e i Z e i d e i Z e i d e i Z e i d e i Z e i d Z e i d Z e i d Z e i d Z h e e f d 6e e f d 6Z h e d 6e d 6e d 6e d 6e d 6e d 6e d 6e d 6Z d/ d/ e d Z d Z d/ d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z e d! Z! d" Z" d# Z# d$ Z$ d% Z% d& Z& d' Z' d( Z( d) Z) d* Z* d/ d/ d+ Z+ e e d/ d, Z, d- Z- d. Z. RS(0 s2 An object to read, create, and write config files.s ^ # line start (\s*) # indentation ( # keyword (?:".*?")| # double quotes (?:'.*?')| # single quotes (?:[^'"=].*?) # no quotes ) \s*=\s* # divider (.*) # value (including list values and comments) $ # line end s= ^ (\s*) # 1: indentation ((?:\[\s*)+) # 2: section marker open ( # 3: section name open (?:"\s*\S.*?\s*")| # at least one non-space with double quotes (?:'\s*\S.*?\s*')| # at least one non-space with single quotes (?:[^'"\s].*?) # at least one non-space unquoted ) # section name close ((?:\s*\])+) # 4: section marker close \s*(\#.*)? # 5: optional comment $s ^ (?: (?: ( (?: (?: (?:".*?")| # double quotes (?:'.*?')| # single quotes (?:[^'",\#][^,\#]*?) # unquoted ) \s*,\s* # comma )* # match all list items ending in a comma (if any) ) ( (?:".*?")| # double quotes (?:'.*?')| # single quotes (?:[^'",\#\s][^,]*?)| # unquoted (?:(? infile must be a filename, file like object, or list of lines.is s s s at line %s.i i s2 Parsing failed with several errors. First error %s( s s s ( s s s (" R] R t filenamet ost patht isfilet openR t closeR2 Rp R1 t writeR RT R R" t _errorsR: t _handle_configspecR3 RE t MISSINGR\ t _handle_bomt endswitht newlinest rstript _parseRk Rz R t errorst config( RG R R3 t hR Rj R R t infot msgt error( ( s- /usr/lib/python2.6/site-packages/configobj.pyR sp . c C s | d j o t } n d | _ g | _ | d | _ | d | _ | d | _ | d | _ | d | _ | d | _ | d | _ | d | _ | d | _ t | _ d | _ | d | _ | d | _ g | _ g | _ d | _ | i o t | _ n t i | d S( NR/ R. R0 R1 R2 R4 R5 R R6 R8 R7 ( R: R R R R/ R. R0 R1 R2 R4 R5 R R6 RW t BOMR R8 R7 t initial_commentt final_commentR3 R R R ( RG R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR s. c C sP d d i g } | i | i D]' } | d t | t | | f q ~ S( Ns ConfigObj({%s})s , s %s: %s( Ry R R R ( RG R R{ ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR @ s c C sd | i d j o* | i i t j o | i | | i St | t t f o | d } n | } | i d j o t | i i } | d j of xO t i D]A \ } \ } } | p q n | i | o | i | | Sq W| i | | i St | } | i | p | i | | i S| t | } t | t t f o | | d | i p | St | t o | i o | i | i S| S( s' Decode element to unicode if necessary.( R R] t strR6 R! ( RG Rj ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt _decode_element s c C s# t | t p t | S| Sd S( sh Used by ``stringify`` within validate, to turn non-string values into strings. N( R] R R% ( RG RM ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt _str s c C s | i } | i o t | _ n g } t } | } t | d } d } t } x| | j o| o g } n | d 7} | | } | i } | p | i d o t } | i | qQ n | p | | _ g } t } n t } | i i | } | d j o| i \ } } } } } | o | i d j o | | _ n | i d } | | i d j o | i d t | | qQ n | | i j oL y | i | | i } Wq4t j o | i d t | | qQ q4XnR | | i j o | i } n5 | | i d j o | } n | i d t | | | i | } | i | o | i d t | | qQ n t | | | d | } | | | <| | i | <| | i | R0 t singlet empty_listRC R R R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR5 s6 * c C sF | d } | d } | i | d } | i | d } | i | } | d j o$ t | i } | i | | S| i | d j o t n x^ | | j oG | d 7} | d 7} | | } | i | d j o | | 7} q Pq Wt | i | } | d j o t n | i \ } } | | | | f S( s9 Extract the value, where we are in a multiline situation.i i i is N( t _triple_quoteR} R: R R- R RY Rl ( RG RM R R; R: RV t newvaluet single_linet multi_lineR> t retvalRj RC ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR3 9 s2 c C s t | t pr y" t | d t d t d t } Wq t j o } t d | q t j o } t d | q Xn | | _ d S( s Parse the configspec.R/ R2 R s Parsing configspec failed: %ss Reading configspec failed: %sN( R] R" RV R R! Rp R3 ( RG R3 RE ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR \ s c C s | i } | i d } t | t o6 x3 | i D]$ } | | j o | | | _ q2 q2 Wn x | i D] } | d j o qh n | | j oQ h | | <| o< | i i | g | i | <| i i | d | i | | i d j o t | _ n g } | i d } | i d } | d j o~ | i } t | _ | } xc | i D]T } | i | } | i } | o | i | o | | } n | i | qp Wn | i | i } x!| i | i D]} | | i j o q n xa | i | D]R } | i | i } | o | i | o | | } n | i | | qW| | } | i | i | } t | t o? | i | i | | i | | | i | i d | q | i | i | | | | q W| | j oo x_ | i D]T } | i | } | i } | o | i | o | | } n | i | qW| | _ n | | j o | S| i d j o | d j o | i o1 g } | D] } | | i | i q~ } n | i o] | i d j p t i | i i d j o. | p | i d n t! | d | d>> filename = a.filename >>> a.filename = 'test.ini' >>> a.write() >>> a.filename = filename >>> a == ConfigObj('test.ini', raise_errors=True) 1 R( s # Rs R Ri i t wbN(* R5 R: R R# R. RW R R& R+ R R R R R R R t lstripRm R R] R Rl t extendR Rk R R R t encodeR R R R R R R t linesepRy R R R R ( RG t outfileRs R t cst cspt int_valRj t stripped_lineRj R t comment_lineR RC R t lR t outputR ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR s 1 * c s d j o i d j o t d n o d d k l } | _ n o^ i i _ i i _ i i _ i i _ i i _ i i _ q n i i f d } h t } t } g } i D] } | j o | | qq~ } g } i D]! } | i j o | | qOqO~ } g } i D]! } | i j o | | qq~ } x i D] } | d j o qn | i j p | i j oc t } d } oL | i j o< i i | g i | < i i | d i | >> import validate >>> vtor = validate.Validator() >>> my_ini = ''' ... option1 = True ... [section1] ... option1 = True ... [section2] ... another_option = Probably ... [section3] ... another_option = True ... [[section3b]] ... value = 3 ... value2 = a ... value3 = 11 ... ''' >>> my_cfg = ''' ... option1 = boolean() ... option2 = boolean() ... option3 = boolean(default=Bad_value) ... [section1] ... option1 = boolean() ... option2 = boolean() ... option3 = boolean(default=Bad_value) ... [section2] ... another_option = boolean() ... [section3] ... another_option = boolean() ... [[section3b]] ... value = integer ... value2 = integer ... value3 = integer(0, 10) ... [[[section3b-sub]]] ... value = string ... [section4] ... another_option = boolean() ... ''' >>> cs = my_cfg.split('\n') >>> ini = my_ini.split('\n') >>> cfg = ConfigObj(ini, configspec=cs) >>> res = cfg.validate(vtor, preserve_errors=True) >>> errors = [] >>> for entry in flatten_errors(cfg, res): ... section_list, key, error = entry ... section_list.insert(0, '[root]') ... if key is not None: ... section_list.append(key) ... else: ... section_list.append('[missing]') ... section_string = ', '.join(section_list) ... errors.append((section_string, ' = ', error)) >>> errors.sort() >>> for entry in errors: ... print entry[0], entry[1], (entry[2] or 0) [root], option2 = 0 [root], option3 = the value "Bad_value" is of the wrong type. [root], section1, option2 = 0 [root], section1, option3 = the value "Bad_value" is of the wrong type. [root], section2, another_option = the value "Probably" is of the wrong type. [root], section3, section3b, section3b-sub, [missing] = 0 [root], section3, section3b, value2 = the value "a" is of the wrong type. [root], section3, section3b, value3 = the value "11" is too big. [root], section4, [missing] = 0 N( R: RV RW R] R R R R R R R, ( t cfgt rest levelst resultsR{ R ( ( s- /usr/lib/python2.6/site-packages/configobj.pyR, s, a (C t __future__R t sysR R R: R9 R; t codecsR R R R t byteorderR R R R RW RX RN RO R[ RZ R t NameErrort objectR R t __revision__R+ t __all__R R t MAX_INTERPOL_DEPTHRV RW R R@ R R* RC Rh R7 Rl R R R Rp R( R R! R$ R% R' R& R) Rr R R R R R R R" R# R, ( ( ( s- /usr/lib/python2.6/site-packages/configobj.pyt s & 8 w X }