blob: cabbbdcf4f077e353332d0e511ad5d58dc3bc3a4 [file] [log] [blame]
Guido van Rossum3d209861997-12-09 16:10:31 +00001"""Configuration file parser.
2
3A setup file consists of sections, lead by a "[section]" header,
4and followed by "name: value" entries, with continuations and such in
Barry Warsawbfa3f6b1998-07-01 20:41:12 +00005the style of RFC 822.
Guido van Rossum3d209861997-12-09 16:10:31 +00006
Barry Warsawbfa3f6b1998-07-01 20:41:12 +00007The option values can contain format strings which refer to other values in
8the same section, or values in a special [DEFAULT] section.
9
Guido van Rossum3d209861997-12-09 16:10:31 +000010For example:
11
12 something: %(dir)s/whatever
13
14would resolve the "%(dir)s" to the value of dir. All reference
15expansions are done late, on demand.
16
17Intrinsic defaults can be specified by passing them into the
18ConfigParser constructor as a dictionary.
19
20class:
21
22ConfigParser -- responsible for for parsing a list of
23 configuration files, and managing the parsed database.
24
25 methods:
26
Barry Warsawf09f6a51999-01-26 22:01:37 +000027 __init__(defaults=None)
28 create the parser and specify a dictionary of intrinsic defaults. The
29 keys must be strings, the values must be appropriate for %()s string
30 interpolation. Note that `__name__' is always an intrinsic default;
31 it's value is the section's name.
Guido van Rossum3d209861997-12-09 16:10:31 +000032
Barry Warsawf09f6a51999-01-26 22:01:37 +000033 sections()
34 return all the configuration section names, sans DEFAULT
Guido van Rossum3d209861997-12-09 16:10:31 +000035
Guido van Rossuma5a24b71999-10-04 19:58:22 +000036 has_section(section)
37 return whether the given section exists
38
Eric S. Raymond649685a2000-07-14 14:28:22 +000039 has_option(section, option)
40 return whether the given option exists in the given section
41
Barry Warsawf09f6a51999-01-26 22:01:37 +000042 options(section)
43 return list of configuration options for the named section
Guido van Rossum3d209861997-12-09 16:10:31 +000044
Guido van Rossuma5a24b71999-10-04 19:58:22 +000045 has_option(section, option)
46 return whether the given section has the given option
47
Guido van Rossumc0780ac1999-01-30 04:35:47 +000048 read(filenames)
Guido van Rossum6a8d84b1999-10-04 18:57:27 +000049 read and parse the list of named configuration files, given by
50 name. A single filename is also allowed. Non-existing files
51 are ignored.
52
53 readfp(fp, filename=None)
54 read and parse one configuration file, given as a file object.
55 The filename defaults to fp.name; it is only used in error
Barry Warsaw25394511999-10-12 16:12:48 +000056 messages (if fp has no `name' attribute, the string `<???>' is used).
Guido van Rossum3d209861997-12-09 16:10:31 +000057
Barry Warsawf09f6a51999-01-26 22:01:37 +000058 get(section, option, raw=0, vars=None)
59 return a string value for the named option. All % interpolations are
60 expanded in the return values, based on the defaults passed into the
61 constructor and the DEFAULT section. Additional substitutions may be
62 provided using the `vars' argument, which must be a dictionary whose
63 contents override any pre-existing defaults.
Guido van Rossum3d209861997-12-09 16:10:31 +000064
Barry Warsawf09f6a51999-01-26 22:01:37 +000065 getint(section, options)
66 like get(), but convert value to an integer
Guido van Rossum3d209861997-12-09 16:10:31 +000067
Barry Warsawf09f6a51999-01-26 22:01:37 +000068 getfloat(section, options)
69 like get(), but convert value to a float
Guido van Rossum3d209861997-12-09 16:10:31 +000070
Barry Warsawf09f6a51999-01-26 22:01:37 +000071 getboolean(section, options)
72 like get(), but convert value to a boolean (currently defined as 0 or
73 1, only)
Eric S. Raymond649685a2000-07-14 14:28:22 +000074
75 remove_section(section)
Tim Peters88869f92001-01-14 23:36:06 +000076 remove the given file section and all its options
Eric S. Raymond649685a2000-07-14 14:28:22 +000077
78 remove_option(section, option)
Tim Peters88869f92001-01-14 23:36:06 +000079 remove the given option from the given section
Eric S. Raymond649685a2000-07-14 14:28:22 +000080
81 set(section, option, value)
82 set the given option
83
84 write(fp)
Tim Peters88869f92001-01-14 23:36:06 +000085 write the configuration state in .ini format
Guido van Rossum3d209861997-12-09 16:10:31 +000086"""
87
88import sys
89import string
Barry Warsawbfa3f6b1998-07-01 20:41:12 +000090import re
Guido van Rossum3d209861997-12-09 16:10:31 +000091
Skip Montanaroe99d5ea2001-01-20 19:54:20 +000092__all__ = ["NoSectionError","DuplicateSectionError","NoOptionError",
93 "InterpolationError","InterpolationDepthError","ParsingError",
94 "MissingSectionHeaderError","ConfigParser",
95 "MAX_INTERPOLATION_DEPTH"]
96
Guido van Rossum3d209861997-12-09 16:10:31 +000097DEFAULTSECT = "DEFAULT"
98
Fred Drake2a37f9f2000-09-27 22:43:54 +000099MAX_INTERPOLATION_DEPTH = 10
100
Guido van Rossum3d209861997-12-09 16:10:31 +0000101
Tim Peters88869f92001-01-14 23:36:06 +0000102
Guido van Rossum3d209861997-12-09 16:10:31 +0000103# exception classes
Fred Drake7c1e5ad2000-12-11 18:13:19 +0000104class Error(Exception):
Guido van Rossum3d209861997-12-09 16:10:31 +0000105 def __init__(self, msg=''):
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000106 self._msg = msg
Fred Drake7c1e5ad2000-12-11 18:13:19 +0000107 Exception.__init__(self, msg)
Guido van Rossum3d209861997-12-09 16:10:31 +0000108 def __repr__(self):
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000109 return self._msg
Fred Drake7c1e5ad2000-12-11 18:13:19 +0000110 __str__ = __repr__
Guido van Rossum3d209861997-12-09 16:10:31 +0000111
112class NoSectionError(Error):
113 def __init__(self, section):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000114 Error.__init__(self, 'No section: %s' % section)
115 self.section = section
Guido van Rossum3d209861997-12-09 16:10:31 +0000116
117class DuplicateSectionError(Error):
118 def __init__(self, section):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000119 Error.__init__(self, "Section %s already exists" % section)
120 self.section = section
Guido van Rossum3d209861997-12-09 16:10:31 +0000121
122class NoOptionError(Error):
123 def __init__(self, option, section):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000124 Error.__init__(self, "No option `%s' in section: %s" %
125 (option, section))
126 self.option = option
127 self.section = section
Guido van Rossum3d209861997-12-09 16:10:31 +0000128
129class InterpolationError(Error):
Barry Warsaw64462121998-08-06 18:48:41 +0000130 def __init__(self, reference, option, section, rawval):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000131 Error.__init__(self,
Barry Warsaw64462121998-08-06 18:48:41 +0000132 "Bad value substitution:\n"
133 "\tsection: [%s]\n"
134 "\toption : %s\n"
135 "\tkey : %s\n"
136 "\trawval : %s\n"
137 % (section, option, reference, rawval))
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000138 self.reference = reference
139 self.option = option
140 self.section = section
Guido van Rossum3d209861997-12-09 16:10:31 +0000141
Fred Drake2a37f9f2000-09-27 22:43:54 +0000142class InterpolationDepthError(Error):
143 def __init__(self, option, section, rawval):
144 Error.__init__(self,
145 "Value interpolation too deeply recursive:\n"
146 "\tsection: [%s]\n"
147 "\toption : %s\n"
148 "\trawval : %s\n"
149 % (section, option, rawval))
150 self.option = option
151 self.section = section
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000152
153class ParsingError(Error):
154 def __init__(self, filename):
155 Error.__init__(self, 'File contains parsing errors: %s' % filename)
156 self.filename = filename
157 self.errors = []
158
159 def append(self, lineno, line):
160 self.errors.append((lineno, line))
161 self._msg = self._msg + '\n\t[line %2d]: %s' % (lineno, line)
162
Fred Drake2a37f9f2000-09-27 22:43:54 +0000163class MissingSectionHeaderError(ParsingError):
164 def __init__(self, filename, lineno, line):
165 Error.__init__(
166 self,
167 'File contains no section headers.\nfile: %s, line: %d\n%s' %
168 (filename, lineno, line))
169 self.filename = filename
170 self.lineno = lineno
171 self.line = line
172
Guido van Rossum3d209861997-12-09 16:10:31 +0000173
Tim Peters88869f92001-01-14 23:36:06 +0000174
Guido van Rossum3d209861997-12-09 16:10:31 +0000175class ConfigParser:
176 def __init__(self, defaults=None):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000177 self.__sections = {}
178 if defaults is None:
179 self.__defaults = {}
180 else:
181 self.__defaults = defaults
Guido van Rossum3d209861997-12-09 16:10:31 +0000182
183 def defaults(self):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000184 return self.__defaults
Guido van Rossum3d209861997-12-09 16:10:31 +0000185
186 def sections(self):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000187 """Return a list of section names, excluding [DEFAULT]"""
188 # self.__sections will never have [DEFAULT] in it
189 return self.__sections.keys()
Guido van Rossum3d209861997-12-09 16:10:31 +0000190
191 def add_section(self, section):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000192 """Create a new section in the configuration.
Guido van Rossum3d209861997-12-09 16:10:31 +0000193
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000194 Raise DuplicateSectionError if a section by the specified name
195 already exists.
196 """
197 if self.__sections.has_key(section):
198 raise DuplicateSectionError(section)
199 self.__sections[section] = {}
Guido van Rossum3d209861997-12-09 16:10:31 +0000200
201 def has_section(self, section):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000202 """Indicate whether the named section is present in the configuration.
Guido van Rossum3d209861997-12-09 16:10:31 +0000203
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000204 The DEFAULT section is not acknowledged.
205 """
Fred Drake2a37f9f2000-09-27 22:43:54 +0000206 return section in self.sections()
Guido van Rossum3d209861997-12-09 16:10:31 +0000207
208 def options(self, section):
Guido van Rossuma5a24b71999-10-04 19:58:22 +0000209 """Return a list of option names for the given section name."""
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000210 try:
211 opts = self.__sections[section].copy()
212 except KeyError:
213 raise NoSectionError(section)
214 opts.update(self.__defaults)
Fred Drake2a37f9f2000-09-27 22:43:54 +0000215 if opts.has_key('__name__'):
216 del opts['__name__']
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000217 return opts.keys()
Guido van Rossum3d209861997-12-09 16:10:31 +0000218
Guido van Rossuma5a24b71999-10-04 19:58:22 +0000219 def has_option(self, section, option):
220 """Return whether the given section has the given option."""
Fred Drake2a37f9f2000-09-27 22:43:54 +0000221 return option in self.options(section)
Guido van Rossuma5a24b71999-10-04 19:58:22 +0000222
Guido van Rossum3d209861997-12-09 16:10:31 +0000223 def read(self, filenames):
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000224 """Read and parse a filename or a list of filenames.
Tim Peters88869f92001-01-14 23:36:06 +0000225
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000226 Files that cannot be opened are silently ignored; this is
Barry Warsaw25394511999-10-12 16:12:48 +0000227 designed so that you can specify a list of potential
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000228 configuration file locations (e.g. current directory, user's
229 home directory, systemwide directory), and all existing
230 configuration files in the list will be read. A single
231 filename may also be given.
232 """
Fred Drakefd4114e2000-05-09 14:46:40 +0000233 if type(filenames) in [type(''), type(u'')]:
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000234 filenames = [filenames]
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000235 for filename in filenames:
236 try:
237 fp = open(filename)
238 except IOError:
239 continue
240 self.__read(fp, filename)
Fred Drake2438a481999-10-04 18:11:56 +0000241 fp.close()
Guido van Rossum3d209861997-12-09 16:10:31 +0000242
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000243 def readfp(self, fp, filename=None):
244 """Like read() but the argument must be a file-like object.
245
246 The `fp' argument must have a `readline' method. Optional
247 second argument is the `filename', which if not given, is
248 taken from fp.name. If fp has no `name' attribute, `<???>' is
249 used.
250
251 """
252 if filename is None:
253 try:
254 filename = fp.name
255 except AttributeError:
256 filename = '<???>'
257 self.__read(fp, filename)
258
Guido van Rossume6506e71999-01-26 19:29:25 +0000259 def get(self, section, option, raw=0, vars=None):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000260 """Get an option value for a given section.
Guido van Rossum3d209861997-12-09 16:10:31 +0000261
Barry Warsawf09f6a51999-01-26 22:01:37 +0000262 All % interpolations are expanded in the return values, based on the
263 defaults passed into the constructor, unless the optional argument
264 `raw' is true. Additional substitutions may be provided using the
265 `vars' argument, which must be a dictionary whose contents overrides
266 any pre-existing defaults.
Guido van Rossum3d209861997-12-09 16:10:31 +0000267
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000268 The section DEFAULT is special.
269 """
270 try:
271 sectdict = self.__sections[section].copy()
272 except KeyError:
273 if section == DEFAULTSECT:
274 sectdict = {}
275 else:
276 raise NoSectionError(section)
277 d = self.__defaults.copy()
278 d.update(sectdict)
Guido van Rossume6506e71999-01-26 19:29:25 +0000279 # Update with the entry specific variables
280 if vars:
281 d.update(vars)
Guido van Rossum9e480ad1999-06-17 18:41:42 +0000282 option = self.optionxform(option)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000283 try:
284 rawval = d[option]
285 except KeyError:
286 raise NoOptionError(option, section)
Fred Drake2a37f9f2000-09-27 22:43:54 +0000287
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000288 if raw:
289 return rawval
Guido van Rossum3d209861997-12-09 16:10:31 +0000290
Fred Drake2a37f9f2000-09-27 22:43:54 +0000291 # do the string interpolation
Guido van Rossume6506e71999-01-26 19:29:25 +0000292 value = rawval # Make it a pretty variable name
Tim Peters88869f92001-01-14 23:36:06 +0000293 depth = 0
Guido van Rossum72ce8581999-02-12 14:13:10 +0000294 while depth < 10: # Loop through this until it's done
295 depth = depth + 1
Eric S. Raymond9eb54d92001-02-09 05:19:09 +0000296 if value.find("%(") >= 0:
Guido van Rossume6506e71999-01-26 19:29:25 +0000297 try:
298 value = value % d
299 except KeyError, key:
300 raise InterpolationError(key, option, section, rawval)
301 else:
Fred Drake2a37f9f2000-09-27 22:43:54 +0000302 break
303 if value.find("%(") >= 0:
304 raise InterpolationDepthError(option, section, rawval)
305 return value
Tim Peters88869f92001-01-14 23:36:06 +0000306
Guido van Rossum3d209861997-12-09 16:10:31 +0000307 def __get(self, section, conv, option):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000308 return conv(self.get(section, option))
Guido van Rossum3d209861997-12-09 16:10:31 +0000309
310 def getint(self, section, option):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000311 return self.__get(section, string.atoi, option)
Guido van Rossum3d209861997-12-09 16:10:31 +0000312
313 def getfloat(self, section, option):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000314 return self.__get(section, string.atof, option)
Guido van Rossum3d209861997-12-09 16:10:31 +0000315
316 def getboolean(self, section, option):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000317 v = self.get(section, option)
Eric S. Raymondf2960192001-02-09 05:37:25 +0000318 val = int(v)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000319 if val not in (0, 1):
320 raise ValueError, 'Not a boolean: %s' % v
321 return val
Guido van Rossum3d209861997-12-09 16:10:31 +0000322
Guido van Rossum9e480ad1999-06-17 18:41:42 +0000323 def optionxform(self, optionstr):
Eric S. Raymond9eb54d92001-02-09 05:19:09 +0000324 return optionstr.lower()
Guido van Rossum9e480ad1999-06-17 18:41:42 +0000325
Eric S. Raymond417c4892000-07-10 18:11:00 +0000326 def has_option(self, section, option):
327 """Check for the existence of a given option in a given section."""
328 if not section or section == "DEFAULT":
329 return self.__defaults.has_key(option)
330 elif not self.has_section(section):
331 return 0
332 else:
Fred Drake3c823aa2001-02-26 21:55:34 +0000333 option = self.optionxform(option)
Eric S. Raymond417c4892000-07-10 18:11:00 +0000334 return self.__sections[section].has_key(option)
335
336 def set(self, section, option, value):
337 """Set an option."""
338 if not section or section == "DEFAULT":
339 sectdict = self.__defaults
340 else:
341 try:
342 sectdict = self.__sections[section]
343 except KeyError:
344 raise NoSectionError(section)
Fred Drake3c823aa2001-02-26 21:55:34 +0000345 option = self.optionxform(option)
Eric S. Raymond417c4892000-07-10 18:11:00 +0000346 sectdict[option] = value
347
348 def write(self, fp):
349 """Write an .ini-format representation of the configuration state."""
350 if self.__defaults:
351 fp.write("[DEFAULT]\n")
Eric S. Raymond649685a2000-07-14 14:28:22 +0000352 for (key, value) in self.__defaults.items():
353 fp.write("%s = %s\n" % (key, value))
Eric S. Raymond417c4892000-07-10 18:11:00 +0000354 fp.write("\n")
355 for section in self.sections():
356 fp.write("[" + section + "]\n")
357 sectdict = self.__sections[section]
Eric S. Raymond649685a2000-07-14 14:28:22 +0000358 for (key, value) in sectdict.items():
Eric S. Raymond417c4892000-07-10 18:11:00 +0000359 if key == "__name__":
360 continue
Eric S. Raymond649685a2000-07-14 14:28:22 +0000361 fp.write("%s = %s\n" % (key, value))
Eric S. Raymond417c4892000-07-10 18:11:00 +0000362 fp.write("\n")
363
Thomas Woutersff4df6d2000-07-21 05:19:59 +0000364 def remove_option(self, section, option):
Eric S. Raymond649685a2000-07-14 14:28:22 +0000365 """Remove an option."""
366 if not section or section == "DEFAULT":
367 sectdict = self.__defaults
368 else:
369 try:
370 sectdict = self.__sections[section]
371 except KeyError:
372 raise NoSectionError(section)
Fred Drake3c823aa2001-02-26 21:55:34 +0000373 option = self.optionxform(option)
Fred Drakeff4a23b2000-12-04 16:29:13 +0000374 existed = sectdict.has_key(option)
Eric S. Raymond649685a2000-07-14 14:28:22 +0000375 if existed:
Fred Drakeff4a23b2000-12-04 16:29:13 +0000376 del sectdict[option]
Eric S. Raymond649685a2000-07-14 14:28:22 +0000377 return existed
378
Thomas Woutersff4df6d2000-07-21 05:19:59 +0000379 def remove_section(self, section):
Eric S. Raymond649685a2000-07-14 14:28:22 +0000380 """Remove a file section."""
381 if self.__sections.has_key(section):
382 del self.__sections[section]
383 return 1
384 else:
385 return 0
386
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000387 #
388 # Regular expressions for parsing section headers and options. Note a
389 # slight semantic change from the previous version, because of the use
390 # of \w, _ is allowed in section header names.
Guido van Rossum9e480ad1999-06-17 18:41:42 +0000391 SECTCRE = re.compile(
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000392 r'\[' # [
Fred Draked4df94b2001-02-14 15:24:17 +0000393 r'(?P<header>[^]]+)' # very permissive!
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000394 r'\]' # ]
395 )
Guido van Rossum9e480ad1999-06-17 18:41:42 +0000396 OPTCRE = re.compile(
Fred Draked83bbbf2001-02-12 17:18:11 +0000397 r'(?P<option>[]\-[\w_.*,(){}]+)' # a lot of stuff found by IvL
Fred Drakec517b9b2000-02-28 20:59:03 +0000398 r'[ \t]*(?P<vi>[:=])[ \t]*' # any number of space/tab,
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000399 # followed by separator
400 # (either : or =), followed
401 # by any # space/tab
402 r'(?P<value>.*)$' # everything up to eol
403 )
404
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000405 def __read(self, fp, fpname):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000406 """Parse a sectioned setup file.
Guido van Rossum3d209861997-12-09 16:10:31 +0000407
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000408 The sections in setup file contains a title line at the top,
409 indicated by a name in square brackets (`[]'), plus key/value
410 options lines, indicated by `name: value' format lines.
411 Continuation are represented by an embedded newline then
412 leading whitespace. Blank lines, lines beginning with a '#',
413 and just about everything else is ignored.
414 """
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000415 cursect = None # None, or a dictionary
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000416 optname = None
417 lineno = 0
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000418 e = None # None, or an exception
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000419 while 1:
420 line = fp.readline()
421 if not line:
422 break
423 lineno = lineno + 1
424 # comment or blank line?
Eric S. Raymond9eb54d92001-02-09 05:19:09 +0000425 if line.strip() == '' or line[0] in '#;':
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000426 continue
Eric S. Raymond9eb54d92001-02-09 05:19:09 +0000427 if line.split()[0].lower() == 'rem' \
Fred Drakec517b9b2000-02-28 20:59:03 +0000428 and line[0] in "rR": # no leading whitespace
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000429 continue
430 # continuation line?
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000431 if line[0] in ' \t' and cursect is not None and optname:
Eric S. Raymond9eb54d92001-02-09 05:19:09 +0000432 value = line.strip()
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000433 if value:
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000434 cursect[optname] = cursect[optname] + '\n ' + value
435 # a section header or option header?
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000436 else:
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000437 # is it a section header?
Guido van Rossum9e480ad1999-06-17 18:41:42 +0000438 mo = self.SECTCRE.match(line)
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000439 if mo:
440 sectname = mo.group('header')
441 if self.__sections.has_key(sectname):
442 cursect = self.__sections[sectname]
443 elif sectname == DEFAULTSECT:
444 cursect = self.__defaults
445 else:
Barry Warsaw64462121998-08-06 18:48:41 +0000446 cursect = {'__name__': sectname}
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000447 self.__sections[sectname] = cursect
448 # So sections can't start with a continuation line
449 optname = None
450 # no section header in the file?
451 elif cursect is None:
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000452 raise MissingSectionHeaderError(fpname, lineno, `line`)
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000453 # an option line?
454 else:
Guido van Rossum9e480ad1999-06-17 18:41:42 +0000455 mo = self.OPTCRE.match(line)
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000456 if mo:
Fred Drakec517b9b2000-02-28 20:59:03 +0000457 optname, vi, optval = mo.group('option', 'vi', 'value')
Jeremy Hylton820314e2000-03-03 20:43:57 +0000458 if vi in ('=', ':') and ';' in optval:
Fred Drakec517b9b2000-02-28 20:59:03 +0000459 # ';' is a comment delimiter only if it follows
460 # a spacing character
Eric S. Raymond9eb54d92001-02-09 05:19:09 +0000461 pos = optval.find(';')
Fred Drakec517b9b2000-02-28 20:59:03 +0000462 if pos and optval[pos-1] in string.whitespace:
463 optval = optval[:pos]
Eric S. Raymond9eb54d92001-02-09 05:19:09 +0000464 optval = optval.strip()
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000465 # allow empty values
466 if optval == '""':
467 optval = ''
Guido van Rossum41267362000-09-25 14:42:33 +0000468 cursect[self.optionxform(optname)] = optval
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000469 else:
470 # a non-fatal parsing error occurred. set up the
471 # exception but keep going. the exception will be
472 # raised at the end of the file and will contain a
473 # list of all bogus lines
474 if not e:
Guido van Rossum6a8d84b1999-10-04 18:57:27 +0000475 e = ParsingError(fpname)
Barry Warsawbfa3f6b1998-07-01 20:41:12 +0000476 e.append(lineno, `line`)
477 # if any parsing errors occurred, raise an exception
478 if e:
479 raise e