lisa.tests.base.TestConfBase#

class lisa.tests.base.TestConfBase(conf=None, src='user', add_default_src=True)[source]#

Bases: SimpleMultiSrcConf

Base class for test configurations.

This class will add a test-conf top-level key above the level specified by the class, so that if the class specifies a TopLevelKeyDesc('foo'), the actual top-level key will be test-conf/foo.

Warning

Arbitrary code can be executed while loading an instance from a YAML or Pickle file. To include untrusted data in YAML, use the !untrusted tag along with a string

Attributes

`ATTRIBUTES_SERIALIZATION` ^inherited	Attributes to be treated specially during serialization.
`DEFAULT_SERIALIZATION_FMT` ^inherited	Default format used when serializing objects.
`DEFAULT_SRC` ^inherited	Source added automatically using `add_src()` under the name ‘default’ when instances are built.
`YAML_ENCODING` ^inherited	Encoding used for YAML files.
`__reversed__` ^inherited	See `collections.abc.Mapping.__reversed__`

Properties

`STRUCTURE` ^inherited	Class attribute defining the structure of the configuration file, as a instance of `TopLevelKeyDescBase`.
`as_yaml_map` ^inherited	Give a mapping suitable for storing in a YAML configuration file.
`logger` ^inherited	Convenience short-hand for `self.get_logger()`.

Methods

`__class_getitem__()` ^inherited	See `collections.abc.Iterable.__class_getitem__()`
`__contains__()` ^inherited	See `collections.abc.Mapping.__contains__()`
`__copy__()` ^inherited	Shallow copy of the nested configuration tree, without duplicating the leaf values.
`__deepcopy__()` ^inherited
`__getitem__()` ^inherited
`__getstate__()` ^inherited	Filter instances of `DeferredValue` that are not computed already since their runtime parameters will probably not be available after deserialization.
`__iter__()` ^inherited
`__len__()` ^inherited
`__setstate__()` ^inherited
`add_src()` ^inherited	Add a source of configuration.
`eval_deferred()` ^inherited	Evaluate instances of `DeferredValue` that can be used for values that are expensive to compute.
`force_src()` ^inherited	Force the source priority list for a given key.
`force_src_nested()` ^inherited	Force the source priority list for all the keys defined in the nested mapping `key_src_map`.
`from_map()` ^inherited	Create a new configuration instance, using the output of `to_map()`.
`from_path()` ^inherited	Deserialize an object from a file.
`from_yaml_map()` ^inherited	Allow reloading from a plain mapping, to avoid having to specify a tag in the configuration file. The content is hosted under the top-level key specified in `STRUCTURE`.
`from_yaml_map_list()` ^inherited	Create a mapping of configuration classes to instance, by loading them from the list of paths using `from_yaml_map()` and merging them.
`get()` ^inherited	See `collections.abc.Mapping.get()`
`get_help()` ^inherited
`get_key()` ^inherited	Get the value of the given key. It returns a deepcopy of the value.
`get_logger()` ^inherited	Provides a `logging.Logger` named after `cls`.
`get_nested_key()` ^inherited	Same as `get_key()` but works on a list of keys to access nested mappings.
`get_src_map()` ^inherited	Get a mapping of all sources for the given `key`, in priority order (first item is the highest priority source).
`items()` ^inherited	Override the default definition of `collections.abc.Mapping.items()` to allow not evaluating deferred values if necessary.
`keys()` ^inherited	See `collections.abc.Mapping.keys()`
`log_locals()` ^inherited	Debugging aid: log the local variables of the calling function.
`pretty_format()` ^inherited	Give a pretty string representation of the configuration.
`resolve_src()` ^inherited	Get the source name that will be used to serve the value of `key`.
`set_default_src()` ^inherited	Set the default source priority list.
`to_map()` ^inherited	Export the configuration as a mapping.
`to_path()` ^inherited	Serialize the object to a file.
`to_yaml()` ^inherited	Return a YAML string with the serialized object.
`to_yaml_map()` ^inherited	Write a configuration file, with the key descriptions in comments.
`to_yaml_map_str()` ^inherited	Return the content of the file that would be create by `to_yaml_map()` in a string.
`values()` ^inherited	See `collections.abc.Mapping.values()`

Attributes#

TestConfBase.ATTRIBUTES_SERIALIZATION = {'allowed': [], 'ignored': [], 'placeholders': {}}#

Inherited attribute, see lisa.utils.Serializable.ATTRIBUTES_SERIALIZATION

Attributes to be treated specially during serialization.

TestConfBase.DEFAULT_SERIALIZATION_FMT = 'yaml'#

Inherited attribute, see lisa.utils.Serializable.DEFAULT_SERIALIZATION_FMT

Default format used when serializing objects.

TestConfBase.DEFAULT_SRC = {}#

Inherited attribute, see lisa.conf.MultiSrcConf.DEFAULT_SRC

Source added automatically using add_src() under the name ‘default’ when instances are built.

TestConfBase.YAML_ENCODING = 'utf-8'#

Inherited attribute, see lisa.utils.Serializable.YAML_ENCODING

Encoding used for YAML files.

TestConfBase.__reversed__ = None#

Properties#

abstract property TestConfBase.STRUCTURE#

Inherited property, see lisa.conf.MultiSrcConf.STRUCTURE

Class attribute defining the structure of the configuration file, as a instance of TopLevelKeyDescBase.

property TestConfBase.as_yaml_map#

Inherited property, see lisa.conf.MultiSrcConfABC.as_yaml_map

Give a mapping suitable for storing in a YAML configuration file.

property TestConfBase.logger#

Inherited property, see lisa.utils.Loggable.logger

Convenience short-hand for self.get_logger().

Methods#

classmethod TestConfBase.__class_getitem__()#: Inherited method, see collections.abc.Iterable.__class_getitem__()

TestConfBase.__contains__()#: Inherited method, see collections.abc.Mapping.__contains__()

TestConfBase.__copy__()#

Inherited method, see lisa.conf.MultiSrcConf.__copy__()

Shallow copy of the nested configuration tree, without duplicating the leaf values.

TestConfBase.__deepcopy__(memo)#: Inherited method, see lisa.conf.MultiSrcConf.__deepcopy__()

TestConfBase.__getitem__(key)#: Inherited method, see lisa.conf.MultiSrcConf.__getitem__()

TestConfBase.__getstate__()#

Inherited method, see lisa.conf.MultiSrcConf.__getstate__()

Filter instances of DeferredValue that are not computed already since their runtime parameters will probably not be available after deserialization.

TestConfBase.__iter__()#: Inherited method, see lisa.conf.MultiSrcConf.__iter__()

TestConfBase.__len__()#: Inherited method, see lisa.conf.MultiSrcConf.__len__()

TestConfBase.__setstate__(dct)#: Inherited method, see lisa.utils.Serializable.__setstate__()

TestConfBase.add_src(src, conf, filter_none=False, fallback=False, inplace=True)#

Inherited method, see lisa.conf.MultiSrcConf.add_src()

Add a source of configuration.

TestConfBase.eval_deferred(cls=<class 'lisa.conf.DeferredValue'>, src=None, resolve_src=True, error='raise')#

Inherited method, see lisa.conf.MultiSrcConf.eval_deferred()

Evaluate instances of DeferredValue that can be used for values that are expensive to compute.

TestConfBase.force_src(key, src_prio)#

Inherited method, see lisa.conf.MultiSrcConf.force_src()

Force the source priority list for a given key.

TestConfBase.force_src_nested(key_src_map)#

Inherited method, see lisa.conf.MultiSrcConf.force_src_nested()

Force the source priority list for all the keys defined in the nested mapping key_src_map.

classmethod TestConfBase.from_map(*args, **kwargs)#

Inherited method, see lisa.conf.SimpleMultiSrcConf.from_map()

Create a new configuration instance, using the output of to_map().

classmethod TestConfBase.from_path(filepath, fmt=None)#

Inherited method, see lisa.utils.Serializable.from_path()

Deserialize an object from a file.

classmethod TestConfBase.from_yaml_map(path, add_default_src=True)#

Inherited method, see lisa.conf.MultiSrcConfABC.from_yaml_map()

Allow reloading from a plain mapping, to avoid having to specify a tag in the configuration file. The content is hosted under the top-level key specified in STRUCTURE.

classmethod TestConfBase.from_yaml_map_list(path_list, add_default_src=True)#

Inherited method, see lisa.conf.MultiSrcConfABC.from_yaml_map_list()

Create a mapping of configuration classes to instance, by loading them from the list of paths using from_yaml_map() and merging them.

TestConfBase.get()#: Inherited method, see collections.abc.Mapping.get()

classmethod TestConfBase.get_help(*args, **kwargs)#: Inherited method, see lisa.conf.MultiSrcConf.get_help()

TestConfBase.get_key(key, src=None, eval_deferred=True, quiet=False)#

Inherited method, see lisa.conf.MultiSrcConf.get_key()

Get the value of the given key. It returns a deepcopy of the value.

classmethod TestConfBase.get_logger(suffix=None)#

Inherited method, see lisa.utils.Loggable.get_logger()

Provides a logging.Logger named after cls.

TestConfBase.get_nested_key(key, *args, **kwargs)#

Inherited method, see lisa.conf.MultiSrcConf.get_nested_key()

Same as get_key() but works on a list of keys to access nested mappings.

TestConfBase.get_src_map(key)#

Inherited method, see lisa.conf.MultiSrcConf.get_src_map()

Get a mapping of all sources for the given key, in priority order (first item is the highest priority source).

TestConfBase.items(eval_deferred=True)#

Inherited method, see lisa.conf.MultiSrcConf.items()

Override the default definition of collections.abc.Mapping.items() to allow not evaluating deferred values if necessary.

TestConfBase.keys()#: Inherited method, see collections.abc.Mapping.keys()

classmethod TestConfBase.log_locals(var_names=None, level='debug')#

Inherited method, see lisa.utils.Loggable.log_locals()

Debugging aid: log the local variables of the calling function.

TestConfBase.pretty_format(eval_deferred=False)#

Inherited method, see lisa.conf.MultiSrcConf.pretty_format()

Give a pretty string representation of the configuration.

TestConfBase.resolve_src(key)#

Inherited method, see lisa.conf.MultiSrcConf.resolve_src()

Get the source name that will be used to serve the value of key.

TestConfBase.set_default_src(src_prio)#

Inherited method, see lisa.conf.MultiSrcConf.set_default_src()

Set the default source priority list.

TestConfBase.to_map()#

Inherited method, see lisa.conf.SimpleMultiSrcConf.to_map()

Export the configuration as a mapping.

TestConfBase.to_path(filepath, fmt=None)#

Inherited method, see lisa.utils.Serializable.to_path()

Serialize the object to a file.

TestConfBase.to_yaml()#

Inherited method, see lisa.utils.Serializable.to_yaml()

Return a YAML string with the serialized object.

TestConfBase.to_yaml_map(path, add_placeholder=False, placeholder='<no default>')#

Inherited method, see lisa.conf.SimpleMultiSrcConf.to_yaml_map()

Write a configuration file, with the key descriptions in comments.

TestConfBase.to_yaml_map_str(**kwargs)#

Inherited method, see lisa.conf.MultiSrcConfABC.to_yaml_map_str()

Return the content of the file that would be create by to_yaml_map() in a string.

TestConfBase.values()#: Inherited method, see collections.abc.Mapping.values()

lisa.tests.base.TestConfBase#

Attributes#

Properties#

Methods#

This Page