cs.configutils 20220606

Utility functions and classes for .ini style configuration files.

Utility functions and classes for .ini style configuration files.

Latest release 20220606: HasConfigIni: new info_dict() method (name subject to change) to return a descriptive dict, part of a new scheme I'm trying out to report summary data from commands.

Class ConfigSectionWatcher(collections.abc.Mapping, collections.abc.Collection, collections.abc.Sized, collections.abc.Iterable, collections.abc.Container)

A class for monitoring a particular clause in a config file.

Method ConfigSectionWatcher.__init__(self, config, section, defaults=None): Initialise a ConfigSectionWatcher to monitor a particular section of a config file. config: path of config file or ConfigWatcher section: the section to watch defaults: the defaults section to use, default 'DEFAULT'

Class ConfigWatcher(collections.abc.Mapping, collections.abc.Collection, collections.abc.Sized, collections.abc.Iterable, collections.abc.Container)

A monitor for a windows style .ini file. The current SafeConfigParser object is presented as the .config property.

Class HasConfigIni

Class for objects with a config.ini file. A section of the config is designated "our" configuration and its fields parsed into a TagSet; in particular the field values use the TagSet transcription syntax.

The default implementation is expected to be mixed into a class with a .pathto(rpath) method, such as one which inherits from HasFSPath.

The mixin provides the following attributes:

• config: an on demand property which is a TagSet made from the configuration file section
• config_ini: the relative path to the configuration file
• configpath: the full pathname of the configuration file
• config_flush(): update the configuration file if the tags have been modified

Method HasConfigIni.__init__(self, section, config_ini=None): Initialise the configuration.

Function load_config(config_path, parser=None)

Load a configuration from the named config_path.

If parser is missing or None, use SafeConfigParser (just ConfigParser in Python 3). Return the parser.

Release Log

Release 20220606: HasConfigIni: new info_dict() method (name subject to change) to return a descriptive dict, part of a new scheme I'm trying out to report summary data from commands.

Release 20220430: New HasConfigIni mixin for classes keeping some configuration in a .ini config file section.

Release 20210306: Fix imports from collections.abc.

Release 20190101: Internal changes.

Release 20160828: Update metadata with "install_requires" instead of "requires".

Release 20150118: Initial PyPI release.