def load(self, path="", data=None, mtime=None, relative=True):
"""
Loads the configuration from disk.
It may raise NonExistingSchema exception.
:param path: if relative=True, this is a relative path
to configuration. The absolute path
will be calculated depending on the platform
:type path: str
:param relative: if True, path is relative. If False, it's absolute.
:type relative: bool
:return: True if loaded from disk correctly, False otherwise
:rtype: bool
"""
if relative is True:
config_path = os.path.join(self.get_path_prefix(), path)
else:
config_path = path
schema = self._get_spec()
leap_check(schema is not None, "There is no schema to use.",
NonExistingSchema)
self._config_checker = PluggableConfig(format="json")
self._config_checker.options = copy.deepcopy(schema)
try:
if data is None:
self._config_checker.load(fromfile=config_path, mtime=mtime)
else:
self._config_checker.load(data, mtime=mtime)
except Exception as e:
logger.error("Something went wrong while loading " +
"the config from %s\n%s" % (config_path, e))
self._config_checker = None
return False
return True
def load(self, path="", data=None, mtime=None, relative=True):
"""
Loads the configuration from disk.
It may raise NonExistingSchema exception.
:param path: if relative=True, this is a relative path
to configuration. The absolute path
will be calculated depending on the platform
:type path: str
:param relative: if True, path is relative. If False, it's absolute.
:type relative: bool
:return: True if loaded from disk correctly, False otherwise
:rtype: bool
"""
if relative is True:
config_path = os.path.join(
self.get_path_prefix(), path)
else:
config_path = path
schema = self._get_spec()
leap_check(schema is not None,
"There is no schema to use.", NonExistingSchema)
self._config_checker = PluggableConfig(format="json")
self._config_checker.options = copy.deepcopy(schema)
try:
if data is None:
self._config_checker.load(fromfile=config_path, mtime=mtime)
else:
self._config_checker.load(data, mtime=mtime)
except Exception as e:
logger.error("Something went wrong while loading " +
"the config from %s\n%s" % (config_path, e))
self._config_checker = None
return False
return True
class BaseConfig:
"""
Abstract base class for any JSON based configuration.
"""
__metaclass__ = ABCMeta
"""
Standalone is a class wide parameter.
:param standalone: if True it will return the prefix for a
standalone application. Otherwise, it will
return the system
default for configuration storage.
:type standalone: bool
"""
standalone = False
def __init__(self):
self._data = {}
self._config_checker = None
self._api_version = None
@abstractmethod
def _get_schema(self):
"""
Returns the schema corresponding to the version given.
:rtype: dict or None if the version is not supported.
"""
pass
def _get_spec(self):
"""
Returns the spec object for the specific configuration.
:rtype: dict or None if the version is not supported.
"""
leap_assert(self._api_version is not None,
"You should set the API version.")
return self._get_schema()
def _safe_get_value(self, key):
"""
Tries to return a value only if the config has already been loaded.
:rtype: depends on the config structure, dict, str, array, int
:return: returns the value for the specified key in the config
"""
leap_assert(self._config_checker, "Load the config first")
return self._config_checker.config.get(key, None)
def set_api_version(self, version):
"""
Sets the supported api version.
:param api_version: the version of the api supported by the provider.
:type api_version: str
"""
self._api_version = version
leap_assert(self._get_schema() is not None,
"Version %s is not supported." % (version, ))
def get_path_prefix(self):
"""
Returns the platform dependant path prefixer
"""
return get_platform_prefixer().get_path_prefix(
standalone=self.standalone)
def loaded(self):
"""
Returns True if the configuration has been already
loaded. False otherwise
"""
return self._config_checker is not None
def save(self, path_list):
"""
Saves the current configuration to disk.
:param path_list: list of components that form the relative
path to configuration. The absolute path
will be calculated depending on the platform.
:type path_list: list
:return: True if saved to disk correctly, False otherwise
"""
config_path = os.path.join(self.get_path_prefix(), *(path_list[:-1]))
mkdir_p(config_path)
try:
self._config_checker.serialize(os.path.join(config_path,
path_list[-1]))
except Exception as e:
logger.warning("%s" % (e,))
raise
return True
def load(self, path="", data=None, mtime=None, relative=True):
"""
Loads the configuration from disk.
It may raise NonExistingSchema exception.
:param path: if relative=True, this is a relative path
to configuration. The absolute path
will be calculated depending on the platform
:type path: str
:param relative: if True, path is relative. If False, it's absolute.
:type relative: bool
:return: True if loaded from disk correctly, False otherwise
:rtype: bool
"""
if relative is True:
config_path = os.path.join(
self.get_path_prefix(), path)
else:
config_path = path
schema = self._get_spec()
leap_check(schema is not None,
"There is no schema to use.", NonExistingSchema)
self._config_checker = PluggableConfig(format="json")
self._config_checker.options = copy.deepcopy(schema)
try:
if data is None:
self._config_checker.load(fromfile=config_path, mtime=mtime)
else:
self._config_checker.load(data, mtime=mtime)
except Exception as e:
logger.error("Something went wrong while loading " +
"the config from %s\n%s" % (config_path, e))
self._config_checker = None
return False
return True
class BaseConfig:
"""
Abstract base class for any JSON based configuration.
"""
__metaclass__ = ABCMeta
"""
Standalone is a class wide parameter.
:param standalone: if True it will return the prefix for a
standalone application. Otherwise, it will
return the system
default for configuration storage.
:type standalone: bool
"""
standalone = False
def __init__(self):
self._data = {}
self._config_checker = None
self._api_version = None
@abstractmethod
def _get_schema(self):
"""
Returns the schema corresponding to the version given.
:rtype: dict or None if the version is not supported.
"""
pass
def _get_spec(self):
"""
Returns the spec object for the specific configuration.
:rtype: dict or None if the version is not supported.
"""
leap_assert(self._api_version is not None,
"You should set the API version.")
return self._get_schema()
def _safe_get_value(self, key):
"""
Tries to return a value only if the config has already been loaded.
:rtype: depends on the config structure, dict, str, array, int
:return: returns the value for the specified key in the config
"""
leap_assert(self._config_checker, "Load the config first")
return self._config_checker.config.get(key, None)
def set_api_version(self, version):
"""
Sets the supported api version.
:param api_version: the version of the api supported by the provider.
:type api_version: str
"""
self._api_version = version
leap_assert(self._get_schema() is not None,
"Version %s is not supported." % (version, ))
def get_path_prefix(self):
"""
Returns the platform dependant path prefixer
"""
return get_path_prefix(standalone=self.standalone)
def loaded(self):
"""
Returns True if the configuration has been already
loaded. False otherwise
"""
return self._config_checker is not None
def save(self, path_list):
"""
Saves the current configuration to disk.
:param path_list: list of components that form the relative
path to configuration. The absolute path
will be calculated depending on the platform.
:type path_list: list
:return: True if saved to disk correctly, False otherwise
"""
config_path = os.path.join(self.get_path_prefix(), *(path_list[:-1]))
mkdir_p(config_path)
try:
self._config_checker.serialize(
os.path.join(config_path, path_list[-1]))
except Exception as e:
logger.warning("%s" % (e, ))
raise
return True
def load(self, path="", data=None, mtime=None, relative=True):
"""
Loads the configuration from disk.
It may raise NonExistingSchema exception.
:param path: if relative=True, this is a relative path
to configuration. The absolute path
will be calculated depending on the platform
:type path: str
:param relative: if True, path is relative. If False, it's absolute.
:type relative: bool
:return: True if loaded from disk correctly, False otherwise
:rtype: bool
"""
if relative is True:
config_path = os.path.join(self.get_path_prefix(), path)
else:
config_path = path
schema = self._get_spec()
leap_check(schema is not None, "There is no schema to use.",
NonExistingSchema)
self._config_checker = PluggableConfig(format="json")
self._config_checker.options = copy.deepcopy(schema)
try:
if data is None:
self._config_checker.load(fromfile=config_path, mtime=mtime)
else:
self._config_checker.load(data, mtime=mtime)
except Exception as e:
logger.error("Something went wrong while loading " +
"the config from %s\n%s" % (config_path, e))
self._config_checker = None
return False
return True
