/usr/lib/python3/dist-packages/metaconfig/mconf.py is in python3-metaconfig 0.1.4a1-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 | # BSD Licence
# Copyright (c) 2010, Science & Technology Facilities Council (STFC)
# All rights reserved.
#
# See the LICENSE file in the source distribution of this software for
# the full license text.
"""
metaconfig
----------
We want to do:
{{{
import metaconfig
# Config is a ConfigParser instance (or subclass)
# Returns the lowest level config file available (e.g. if __name__ == 'foo.bar.baz' and there is a config
# defined for 'foo.bar' use that.
config = metaconfig.get_config(__name__)
}}}
These options are bootstraped on entry into Python as:
{{{
import metaconfig
metaconfig.add_config_file(name, path)
metaconfig.add_config(name, configParser)
metaconfig.metaconfig(metaconfig)
metaconfig.metaconfig_file(metaconfig_file)
metaconfig.from_argv()
or something like that
}}}
"""
import sys
import configparser
import re
import logging
import logging.config
log = logging.getLogger(__name__)
class Error(Exception):
pass
DEFAULT_CONFIG_PARSER = configparser.ConfigParser
class MetaConfig(object):
def __init__(self):
self._configs = {}
def add_config_file(self, name, path, ConfigClass=DEFAULT_CONFIG_PARSER):
log.info('Adding config %s from path %s' % (name, path))
conf = ConfigClass()
conf.read([path])
return self.add_config(name, conf)
def add_config_fh(self, name, fileobj, ConfigClass=DEFAULT_CONFIG_PARSER):
log.info('Adding config %s from file object' % name)
conf = ConfigClass()
conf.readfp(fileobj)
return self.add_config(name, conf)
def add_config(self, name, config_parser):
if name in self._configs:
Error("Config %s already exists" % name)
else:
config_parser.__config_name__ = name
self._configs[name] = config_parser
log.info('Config %s added' % name)
return config_parser
def get_config(self, name, ConfigClass=DEFAULT_CONFIG_PARSER, inherit=True):
log.debug('Requested config %s, inherit=%s' % (name, inherit))
if inherit:
parts = name.split('.')
while parts:
name1 = '.'.join(parts)
log.debug("Looking for config %s" % name1)
try:
config = self._configs[name1]
log.debug("Selected config %s" % name1)
return config
except KeyError:
parts = parts[:-1]
if name in self._configs:
log.debug("Selecting config %s" % name)
return self._configs[name]
else:
config = self.add_config(name, ConfigClass())
log.debug("New config %s" % name)
return config
@classmethod
def from_config(klass, config_parser):
mf = klass()
mf._setup_logging(config_parser)
mf._parse_nested_configs(config_parser)
mf._parse_external_configs(config_parser)
return mf
@classmethod
def from_config_file(klass, config_file):
cnf = DEFAULT_CONFIG_PARSER()
cnf.read(config_file)
return klass.from_config(cnf)
@classmethod
def from_config_fh(klass, config_fh):
cnf = DEFAULT_CONFIG_PARSER()
cnf.readfp(config_fh)
return klass.from_config(cnf)
def _parse_nested_configs(self, config_parser):
"""
Parse configs embedded in the metaconfig file.
"""
if not config_parser.has_option('metaconfig', 'configs'):
return
configs = config_parser.get('metaconfig', 'configs').split()
D = {}
for section in config_parser.sections():
mo = re.match(r'(.+?):(.+)', section)
if not mo:
continue
prefix, ssec = mo.groups()
D.setdefault(prefix, []).append(ssec)
for config in configs:
cp = DEFAULT_CONFIG_PARSER()
for ssec in D[config]:
sec = '%s:%s' % (config, ssec)
if ssec.lower() == 'default':
defaults = cp.defaults()
for option in config_parser.options(sec):
defaults[option] = config_parser.get(sec, option,
raw=True)
else:
cp.add_section(ssec)
for option in config_parser.options(sec):
cp.set(ssec, option, config_parser.get(sec, option,
raw=True))
self.add_config(config, cp)
def _parse_external_configs(self, config_parser):
"""
Parse external config files referenced in metaconfig.conf.
"""
pass
#!FIXME: need to name each config.
#if not config_parser.has_option('metaconfig', 'config-files'):
# return
#
#config_files = config_parser.get('metaconfig', 'config-files').split()
#for cf in config_files:
# self.add_config_file(cf)
def _setup_logging(self, config_parser):
"""
Initialise logging from a nested config.
"""
if not config_parser.has_option('metaconfig', 'logging'):
return
logging_file = config_parser.get('metaconfig', 'logging')
logging.config.fileConfig(logging_file)
log.info('Logging configuration initialised from %s' % logging_file)
|