37
def search_conffile():
41
Search for the config file, and return the directory it is in.
42
1. Environment var IVLECONF (path to directory)
39
Search for the config file, and return it as a filename.
40
1. Environment var IVLECONF (full filename).
42
3. /etc/ivle/ivle.conf
44
43
Raises a ConfigError on error.
46
45
if 'IVLECONF' in os.environ:
47
fname = os.path.join(os.environ['IVLECONF'])
46
fname = os.environ['IVLECONF']
48
47
if os.path.exists(fname):
50
if os.path.exists('/etc/ivle'):
52
raise ConfigError("Could not find IVLE config directory")
54
def get_plugin(pluginstr):
55
plugin_path, classname = pluginstr.split('#')
56
# Load the plugin module from somewhere in the Python path
57
# (Note that plugin_path is a fully-qualified Python module name).
59
getattr(__import__(plugin_path, fromlist=[classname]), classname))
49
if os.path.exists('./etc/ivle.conf'):
50
return './etc/ivle.conf'
51
if os.path.exists('/etc/ivle/ivle.conf'):
52
return '/etc/ivle/ivle.conf'
53
raise ConfigError("Could not find IVLE config file")
62
56
class Config(ConfigObj):
67
61
Automatically validates the file against the spec (found in
68
62
./ivle-spec.conf relative to this module).
70
def __init__(self, blank=False, plugins=True, *args, **kwargs):
64
def __init__(self, blank=False, *args, **kwargs):
71
65
"""Initialises a new Config object. Searches for the config file,
72
66
loads it, and validates it.
73
67
@param blank: If blank=True, will create a blank config instead, and
74
68
not search for the config file.
75
@param plugins: If True, will find and index plugins.
76
69
@raise ConfigError: If the config file cannot be found.
78
71
specfile = os.path.join(os.path.dirname(__file__), 'ivle-spec.conf')
80
73
super(Config, self).__init__(configspec=specfile, *args, **kwargs)
82
confdir = search_confdir()
83
conffile = os.path.join(confdir, 'ivle.conf')
75
conffile = search_conffile()
84
76
super(Config, self).__init__(infile=conffile, configspec=specfile,
85
interpolation='template',
87
78
# XXX This doesn't raise errors if it doesn't validate
88
79
self.validate(Validator())
93
self.plugin_configs = {}
94
# Go through the plugin config files, looking for plugins.
95
for pconfn in glob.glob(os.path.join(confdir, 'plugins.d/*.conf')):
96
pconf = ConfigObj(pconfn)
97
for plugin_section in pconf:
98
# We have a plugin path. Resolve it into a class...
99
plugin_path, plugin = get_plugin(plugin_section)
100
self.plugins[plugin_path] = plugin
101
# ... and add it to the registry.
102
self.plugin_configs[plugin] = pconf[plugin_section]
104
# Create a registry mapping plugin classes to paths.
105
self.reverse_plugins = dict([(v, k) for (k, v) in
106
self.plugins.items()])
108
# Create an index of plugins by base class.
109
self.plugin_index = {}
110
for plugin in self.plugins.values():
111
# Getmro returns a tuple of all the super-classes of the plugin
112
for base in inspect.getmro(plugin):
113
if base not in self.plugin_index:
114
self.plugin_index[base] = []
115
self.plugin_index[base].append(plugin)
117
81
def set_by_path(self, path, value=_NO_VALUE, comment=None):
118
82
"""Writes a value to an option, given a '/'-separated path.
119
83
@param path: '/'-separated path to configuration option.