Abstract configuration file parser based on sections and settings

The basic idea of this class is that you subclass it, supplying replacements for the get_handler() and/or add_setting() methods. If your format will handle all sections the same way, just override add_setting(). If it will handle sections differently, override get_handler() to return an appropriate method for processing settings in that section. If you want sections which aren't parsed as settings at all, you'll need to revise the add_section() method to handle such sections differently.

To use your class, you'll create an instance of the parser, then call its readFile(), readStream() or readString() methods to process configuration data from as many sources as you like. What will happens when each setting is received, is of course up to your subclass to determine.

add_section (
        self,
        section,
        lines,
        lineInfo,
        )

add_setting (
        self,
        section,
        name,
        value,
        lineInfo,
        )

get_handler (
        self,
        section,
        lines,
        lineInfo,
        )

parse ( self,  lineSource )

process_settings (
        self,
        section,
        lines,
        handler,
        )

readFile (
        self,
        filename,
        mode='r',
        )

readStream (
        self,
        stream,
        source,
        )

readString (
        self,
        text,
        source='<string>',
        )