Module fancyconfig

source code

A wrapper around ConfigParser that defines syntax and types within the configuration options.

This tries to do for configuration processing what optparse did for command line option processing: A declarative way of handling the main chores.

The idea is that, in a client program, you say something like:

       from pftf.fancyconfig import (Configuration, Section, ConfigError,
               ...(items you want)...)
       
       _config = Config(
               Section(...
                       XYConfigItem(...)
               ),
               Section(...
               ...
               )
       )
                       
       get = _config.get
       set = _config.set
                       
       if __name__=="__main__":
               print fancyconfig.makeTxtDocs(_config)
       else:
               try:
                       fancyconfig.readConfiguration(_config, None, 
                               os.path.join(dataDir, "config"))
               except ConfigError, msg:
                       import sys
                       sys.stderr.write("%s: %s\n"%(
                               sys.argv[0], unicode(msg).encode("utf-8")))
                       sys.exit(0)

and be done with most of it.

For examples of how this is used, see pftf (http://www.tfiu.de/pftf) or pysmap (link coming up).