�
��c@sj
dZd
dk
Z
ddddddd	d
ddd
ddg
ZdZdZdef
d��YZdef
d��YZdef
d��YZdef
d��YZ	def
d��YZ
de
f
d��YZde
f
d��YZde
f
d��YZ
d	ef
d��YZd
ef
d��YZd
fd��YZdef
d��YZdef
d ��YZdS(!sConfiguration file parser.

A setup file consists of sections, lead by a "[section]" header,
and followed by "name: value" entries, with continuations and such in
the style of RFC 822.

The option values can contain format strings which refer to other values in
the same section, or values in a special [DEFAULT] section.

For example:

    something: %(dir)s/whatever

would resolve the "%(dir)s" to the value of dir.  All reference
expansions are done late, on demand.

Intrinsic defaults can be specified by passing them into the
ConfigParser constructor as a dictionary.

class:

ConfigParser -- responsible for parsing a list of
                configuration files, and managing the parsed database.

    methods:

    __init__(defaults=None)
        create the parser and specify a dictionary of intrinsic defaults.  The
        keys must be strings, the values must be appropriate for %()s string
        interpolation.  Note that `__name__' is always an intrinsic default;
        its value is the section's name.

    sections()
        return all the configuration section names, sans DEFAULT

    has_section(section)
        return whether the given section exists

    has_option(section, option)
        return whether the given option exists in the given section

    options(section)
        return list of configuration options for the named section

    read(filenames)
        read and parse the list of named configuration files, given by
        name.  A single filename is also allowed.  Non-existing files
        are ignored.  Return list of successfully read files.

    readfp(fp, filename=None)
        read and parse one configuration file, given as a file object.
        The filename defaults to fp.name; it is only used in error
        messages (if fp has no `name' attribute, the string `<???>' is used).

    get(section, option, raw=False, vars=None)
        return a string value for the named option.  All % interpolations are
        expanded in the return values, based on the defaults passed into the
        constructor and the DEFAULT section.  Additional substitutions may be
        provided using the `vars' argument, which must be a dictionary whose
        contents override any pre-existing defaults.

    getint(section, options)
        like get(), but convert value to an integer

    getfloat(section, options)
        like get(), but convert value to a float

    getboolean(section, options)
        like get(), but convert value to a boolean (currently case
        insensitively defined as 0, false, no, off for False, and 1, true,
        yes, on for True).  Returns False or True.

    items(section, raw=False, vars=None)
        return a list of tuples with (name, value) for each option
        in the section.

    remove_section(section)
        remove the given file section and all its options

    remove_option(section, option)
        remove the given option from the given section

    set(section, option, value)
        set the given option

    write(fp)
        write the configuration state in .ini format
i�NtNoSectionErrortDuplicateSectionErrort
NoOptionErrortInterpolationErrortInterpolationDepthErrortInterpolationSyntaxErrortParsingErrortMissingSectionHeaderErrortConfigParsertSafeConfigParsertRawConfigParsertDEFAULTSECTtMAX_INTERPOLATION_DEPTHtDEFAULTi
tErrorcBs)eZ
dZd
d�Zd�ZeZRS(s'Base class for ConfigParser exceptions.tcCs|
|_t
i||
�
dS(
N(tmessaget	Exceptiont__init__(tselftmsg((s/sys/lib/python/ConfigParser.pyRms
	
c


Cs|iS(
N(
R(
R((s/sys/lib/python/ConfigParser.pyt__repr__qs
(t__name__t
__module__t__doc__RRt__str__(((s/sys/lib/python/ConfigParser.pyRjs
	c
BseZ
dZd
�ZRS(s2Raised when no section matches a requested option.cCs$ti
|d
|
f
�
|
|_dS(NsNo section: %r(RRtsection(RR((s/sys/lib/python/ConfigParser.pyRys

(RRRR(((s/sys/lib/python/ConfigParser.pyRvs
c
BseZ
dZd
�ZRS(s*Raised when a section is multiply-created.cCs!ti
|d
|
�
|
|_dS(NsSection %r already exists(RRR(RR((s/sys/lib/python/ConfigParser.pyR�s

(RRRR(((s/sys/lib/python/ConfigParser.pyR
}s
c
BseZ
dZd
�ZRS(s!A requested option was not found.cCs0ti
|d
|
|f�
|
|_||_dS(NsNo option %r in section: %r(RRtoptionR(RRR((s/sys/lib/python/ConfigParser.pyR�s


	
(RRRR(((s/sys/lib/python/ConfigParser.pyR�s
c
BseZ
dZd
�ZRS(s0Base class for interpolation-related exceptions.cCs&ti
||�
|
|_||_dS(
N(RRRR(RRRR((s/sys/lib/python/ConfigParser.pyR�s

	
(RRRR(((s/sys/lib/python/ConfigParser.pyR�s
tInterpolationMissingOptionErrorc
BseZ
dZd
�ZRS(sAA string substitution required a setting which was not available.cCs9d
||
||f}ti
||
||�
||_dS(NsNBad value substitution:
	section: [%s]
	option : %s
	key    : %s
	rawval : %s
(RRt	reference(RRRtrawvalRR((s/sys/lib/python/ConfigParser.pyR�s


(RRRR(((s/sys/lib/python/ConfigParser.pyR�s
c
BseZ
dZRS(
sjRaised when the source text into which substitutions are made
    does not conform to the required syntax.(RRR(((s/sys/lib/python/ConfigParser.pyR�sc
BseZ
dZd
�ZRS(s0Raised when substitutions are nested too deeply.cCs-d
||
|f}ti
||
||�
dS(NsSValue interpolation too deeply recursive:
	section: [%s]
	option : %s
	rawval : %s
(RR(RRRRR((s/sys/lib/python/ConfigParser.pyR�s

(RRRR(((s/sys/lib/python/ConfigParser.pyR�s
c
Bs eZ
dZd
�Zd�ZRS(s>Raised when a configuration file does not follow legal syntax.cCs*ti
|d
|
�
|
|_g|_dS(Ns File contains parsing errors: %s(RRtfilenameterrors(RR((s/sys/lib/python/ConfigParser.pyR�s

	
cCs3|ii
|
|f�
|id
|
|f7_dS(Ns
	[line %2d]: %s(R tappendR(Rtlinenotline((s/sys/lib/python/ConfigParser.pyR!�s

(RRRRR!(((s/sys/lib/python/ConfigParser.pyR�s
	c
BseZ
dZd
�ZRS(s@Raised when a key-value pair is found before any section header.cCs<ti
|d
|
||f�
|
|_||_||_dS(Ns7File contains no section headers.
file: %s, line: %d
%r(RRRR"R#(RRR"R#((s/sys/lib/python/ConfigParser.pyR�s




	
	
(RRRR(((s/sys/lib/python/ConfigParser.pyR�s
cBs7
eZ
dd�Zd
�Zd�Zd�Zd�Zd�Zd�Z	dd�Z
d�Zd	�Zd
�Z
d�Zd�Zhed
<ed<ed<ed<ed<ed<ed<ed<Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zeid�Zeid�Zd�ZRS( cCsTh|_h|_
|
o7
x4|
i�D]"\}}||i
|i|�<q&Wn

dS(
N(t	_sectionst	_defaultstitemstoptionxform(Rtdefaultstkeytvalue((s/sys/lib/python/ConfigParser.pyR�s
	
	



c


Cs|iS(
N(
R%(
R((s/sys/lib/python/ConfigParser.pyR(�s
c


Cs
|ii
�S(
s3Return a list of section names, excluding [DEFAULT](R$tkeys(
R((s/sys/lib/python/ConfigParser.pytsections�scCs1|
|ijo
t
|
��n

h|i|
<d
S(s�Create a new section in the configuration.

        Raise DuplicateSectionError if a section by the specified name
        already exists.
        N(R$R
(RR((s/sys/lib/python/ConfigParser.pytadd_section�s

cCs
|
|ijS(
s~Indicate whether the named section is present in the configuration.

        The DEFAULT section is not acknowledged.
        (
R$(RR((s/sys/lib/python/ConfigParser.pythas_section�scCsky|i|
i
�}Wntj
o



t|
��n
X|i|i�
d
|jo
|d
=n

|i�S(s9Return a list of option names for the given section name.R(R$tcopytKeyErrorRtupdateR%R+(RRtopts((s/sys/lib/python/ConfigParser.pytoptions�s







cCs�t|
t
�o

|
g
}
n

g}x^|
D]V}yt|�}Wntj
o




q*n
X|i||�
|i�
|i|�
q*W|S(
s�Read and parse a filename or a list of filenames.

        Files that cannot be opened are silently ignored; this is
        designed so that you can specify a list of potential
        configuration file locations (e.g. current directory, user's
        home directory, systemwide directory), and all existing
        configuration files in the list will be read.  A single
        filename may also be given.

        Return list of successfully read files.
        (t
isinstancet
basestringtopentIOErrort_readtcloseR!(Rt	filenamestread_okRtfp((s/sys/lib/python/ConfigParser.pytread�s












cCsN|djo-
y
|
i
}Wq:tj
o




d
}q:
Xn

|i|
|�
dS(s
Like read() but the argument must be a file-like object.

        The `fp' argument must have a `readline' method.  Optional
        second argument is the `filename', which if not given, is
        taken from fp.name.  If fp has no `name' attribute, `<???>' is
        used.

        s<???>N(tNonetnametAttributeErrorR8(RR<R((s/sys/lib/python/ConfigParser.pytreadfp
s	






cCs�|i|�}|
|i
joO
|
tjo
t|
��n

||ijo
|i|Sq�
t||
��nV
||i
|
jo
|i
|
|Sn/
||ijo
|i|Sn
t||
��dS(
N(R'R$RRR%R(RRRtopt((s/sys/lib/python/ConfigParser.pytget 
s










cCs�y|i|
}Wn6t
j
o*



|
tjo
t|
��n

h}n
X|ii�}|i|�
d
|jo
|d
=n

|i�S(NR(R$R0RRR%R/R1R&(RRtd2t
d((s/sys/lib/python/ConfigParser.pyR&0
s













cCs||i|
|��S(
N(
RC(RRtconvR((s/sys/lib/python/ConfigParser.pyt_get=
s
cCs|i|
t
|�S(
N(RGtint(RRR((s/sys/lib/python/ConfigParser.pytgetint@
s
cCs|i|
t
|�S(
N(RGtfloat(RRR((s/sys/lib/python/ConfigParser.pytgetfloatC
s
t
1tyesttruetont
0tnotfalsetoffcCsJ|i|
|�}|i
�|ijo
td
|�n

|i|i
�S(NsNot a boolean: %s(RCtlowert_boolean_statest
ValueError(RRRt
v((s/sys/lib/python/ConfigParser.pyt
getbooleanI
s



c
Cs
|
i�S(
N(
RT(Rt	optionstr((s/sys/lib/python/ConfigParser.pyR'O
s
cCs�|
p

|
tjo 
|i
|�}||ijSnI
|
|ijo
tSn1
|i
|�}||i|
jp

||ijSd
S(s=Check for the existence of a given option in a given section.N(RR'R%R$tFalse(RRR((s/sys/lib/python/ConfigParser.pyt
has_optionR
s





cCsl|
p

|
tjo

|i
}n4
y|i|
}Wntj
o



t|
��n
X|||i|�<d
S(sSet an option.N(RR%R$R0RR'(RRRR*tsectdict((s/sys/lib/python/ConfigParser.pytset^
s





c
Cs	
|iok
|
i
d
t�
xF|ii�D]5\}}|
i
d|t|�idd�f�
q+W|
i
d�
n

x�|iD]�}|
i
d
|�
x[|i|i�D]F\}}|djo-
|
i
d|t|�idd�f�
q�
q�W|
i
d�
qWdS(s?Write an .ini-format representation of the configuration state.s[%s]
s%s = %s
s

s
	RN(R%twriteRR&tstrtreplaceR$(RR<R)R*R((s/sys/lib/python/ConfigParser.pyR^i
s



-







	
(
cCs�|
p

|
tjo

|i
}n4
y|i|
}Wntj
o



t|
��n
X|i|�}||j}|o
||=n

|S(
sRemove an option.(RR%R$R0RR'(RRRR\texisted((s/sys/lib/python/ConfigParser.pyt
remove_optionx
s









cCs(|
|ij}|o
|i|
=n

|S(
sRemove a file section.(
R$(RRRa((s/sys/lib/python/ConfigParser.pytremove_section�s


s\[(?P<header>[^]]+)\]s9(?P<option>[^:=\s][^:=]*)\s*(?P<vi>[:=])\s*(?P<value>.*)$cCs�d}d}d
}d}x�t
o�
|
i�}|p
Pn

|d}|i�djp
|d
djo
qn

|idd�d
i�djo
|d
djo
qn

|d
i�oG
|dj	o:
|o3
|i�}|o
d|||f||<q�
q
|ii|�}	|	op
|	i	d�}
|
|i
jo
|i
|
}n7
|
tjo

|i}n
h|
d	<}||i
|
<d}q
|djo
t
|||��q
|ii|�}	|	o�
|	i	d
dd�\}}}|djoP
d|joC
|id�}
|
djo#
||
di�o
||
 }qB
n

|i�}|djo

d}n

|i|i��}|||<q
|p
t|�}n

|i|t|��
q
W|o

|�n

dS(s�Parse a sectioned setup file.

        The sections in setup file contains a title line at the top,
        indicated by a name in square brackets (`[]'), plus key/value
        options lines, indicated by `name: value' format lines.
        Continuations are represented by an embedded newline then
        leading whitespace.  Blank lines, lines beginning with a '#',
        and just about everything else are ignored.
        ii
Rs#;tremtrRs%s
%stheaderRRtviR*t
=t
:t
;i�s""N(RhRi(R>tTruetreadlinetstriptsplitRTtisspacetSECTCREtmatchtgroupR$RR%RtOPTCREtfindR'trstripRR!trepr(RR<tfpnametcursecttoptnameR"t
eR#R*tmotsectnameRgtoptvaltpos((s/sys/lib/python/ConfigParser.pyR8�s\










$

4%


 
















"









N(RRR>RR(R,R-R.R3R=RARCR&RGRIRKRkRZRURXR'R[R]R^RbRctretcompileRpRsR8(((s/sys/lib/python/ConfigParser.pyR
�s6
			
					
			(
&							

	
	cBsGeZ
edd�Zedd
�Zd�Zeid�Z	d�Z
RS(c
Cs
|ii
�}y|i|i|
�
Wn0tj
o$



|
tjo
t|
��qZ
n
X|o4
x1|i�D]\}}|||i|�<qnWn

|i|�}y||}Wn"tj
o



t	||
��n
X|o
|Sn
|i
|
|||�Sd
S(s�Get an option value for a given section.

        All % interpolations are expanded in the return values, based on the
        defaults passed into the constructor, unless the optional argument
        `raw' is true.  Additional substitutions may be provided using the
        `vars' argument, which must be a dictionary whose contents overrides
        any pre-existing defaults.

        The section DEFAULT is special.
        N(R%R/R1R$R0RRR&R'Rt_interpolate(RRRtrawtvarsRER)R*((s/sys/lib/python/ConfigParser.pyRC�s$














cCs2
|ii
�}y|i|i|
�
Wn0tj
o$



|
tjo
t|
��qZ
n
X|o4
x1|i�D]\}}|||i|�<qnWn

|i	�}d
|jo
|i
d
�
n

|o-
g}|D]}	||	||	fq�~Sn<
g}
|D])}	|
|	|i|
|	||	|�fq�SdS(s�Return a list of tuples with (name, value) for each option
        in the section.

        All % interpolations are expanded in the return values, based on the
        defaults passed into the constructor, unless the optional argument
        `raw' is true.  Additional substitutions may be provided using the
        `vars' argument, which must be a dictionary whose contents overrides
        any pre-existing defaults.

        The section DEFAULT is special.
        RN(R%R/R1R$R0RRR&R'R+tremoveR�(RRR�R�RER)R*R3t_[1]Rt_[2]((s/sys/lib/python/ConfigParser.pyR&s$















&
cCs�|}t}x|ow
|d
8}d|jo[
|i
i|i|�}y||}Wq�tj
o"

}
t||
||d��q�
Xq
Pq
Wd|jo
t||
|��n

|S(Ni
s%(i(Rt_KEYCREtsubt_interpolation_replaceR0RR(RRRRR�R*tdepthRz((s/sys/lib/python/ConfigParser.pyR�/s
















s%\(([^)]*)\)s|.cCs?|
id
�}|djo
|
i�Sn
d|i|�SdS(Ni
s%%(%s)s(RrR>R'(RRqt
s((s/sys/lib/python/ConfigParser.pyR�Ds



N(RRRZR>RCR&R�RR�R�R�(((s/sys/lib/python/ConfigParser.pyR�s
  	cBs5eZ
d�Zeid
�iZd�Zd�ZRS(cCs/g}|i||||
|d
�
di
|�S(Ni
R(t_interpolate_sometjoin(RRRRR�t
L((s/sys/lib/python/ConfigParser.pyR�Ns

s
%\(([^)]+)\)scCs�|tjo
t
|
||��n

x�|o�
|id
�}|djo
|i|�
dSn

|djo
|i|| �
||}n

|dd!}|d
jo
|id
�
|d}q&
|djo�
|i|�}	|	djo
t|
|d|��n

|i|	id��}
||	i	�}y||
}Wn(t
j
o



t|
|||
��n
Xd
|jo$
|i|
|||||d�
q�
|i|�
q&
t|
|d|f
��q&
WdS(Nt
%ii
it
(s'bad interpolation variable reference %rs/'%%' must be followed by '%%' or '(', found: %r(
RRRtR!t_interpvar_matchR>RR'RrtendR0RR�(RRtaccumtrestRtmapR�t
pt
ct
mtvarRW((s/sys/lib/python/ConfigParser.pyR�VsB


























	













cCs:t|t
�p
td
��n

ti||
||�
dS(sASet an option.  Extend ConfigParser.set: check for string values.soption values must be stringsN(R4R5t	TypeErrorRR](RRRR*((s/sys/lib/python/ConfigParser.pyR]|s

(	RRR�RR�RqR�R�R](((s/sys/lib/python/ConfigParser.pyR	Ls		&(RRt__all__RRRRRR
RRRRRRRR
RR	(((s/sys/lib/python/ConfigParser.pys<module>Xs.	



	
	
�_