def get_configuration( self, conf_path, logger, conf=None, override=True ): """ Parse a configuration_files with input conf and returns parameters and errors by param name. :param str conf_path: conf file to parse and from get parameters :param Configuration conf: conf to fill with conf_path values and conf param names. :param Logger logger: logger to use in order to trace information/error :param bool override: if True (by default), override self configuration """ conf_resource = None result = None # ensure conf_path exists and is not empty. if self.exists(conf_path): try: # first, read conf file conf_resource = self._get_conf_resource( conf_path=conf_path, logger=logger ) except Exception as e: # if an error occured, log it logger.error( 'Impossible to parse conf_path {0} with {1}: {2}'.format( conf_path, type(self), e ) ) else: # else process conf file if conf_resource is None: return result result = Configuration() if conf is None else conf categories = self._get_categories( conf_resource=conf_resource, logger=logger ) for category_name in categories: # do something only for referenced categories if category_name in result: category = result.setdefault( category_name, Category(category_name) ) if isinstance(category, Category): parameters = self._get_parameters( conf_resource=conf_resource, category=category, logger=logger ) for name in parameters: # if param name exists in conf if name in category: # copy parameter param = category[name].copy() # else create not local parameter else: param = Parameter(name, local=False) param = category.setdefault(name, param) value = self._get_value( conf_resource=conf_resource, category=category, param=param, logger=logger ) if value not in (None, ''): if override or param.value in (None, ''): param.value = value elif isinstance(category, ParamList): paramlist = category category = Category(category_name) result.categories[category_name] = category parameters = self._get_parameters( conf_resource=conf_resource, category=category, logger=logger ) for name in parameters: param = Parameter( name, local=False, parser=paramlist.parser, asitem=category ) param = category.setdefault(name, param) value = self._get_value( conf_resource=conf_resource, category=category, param=param, logger=logger ) if value not in (None, ''): if override or param.value in (None, ''): param.value = value return result