lisa.conf#

Configuration file management.

Classes

Configurable

Pair a regular class with a configuration class.

DeferredExcep

Specialization of DeferredValue to lazily raise an exception.

DeferredValue

Wrapper similar to functools.partial() allowing to defer computation of the value until the key is accessed.

DelegatedLevelKeyDesc

Level key descriptor that imports the keys from another MultiSrcConfABC subclass.

DerivedKeyDesc

Key descriptor describing a key derived from other keys.

FilteredDeferredValue

Same as lisa.conf.DeferredValue except that the given sentinel value will be interpreted as no value .

KeyDesc

Key descriptor describing a leaf key in the configuration.

KeyDescBase

Base class for configuration files key descriptor.

LevelKeyDesc

Key descriptor defining a hierarchical level in the configuration.

MultiSrcConf

Base class providing layered configuration management.

MultiSrcConfABC

Abstract Base Class of MultiSrcConf.

NestedTopLevelKeyDesc

Top-level key descriptor, with an arbitrary amount of levels.

SimpleMultiSrcConf

Like MultiSrcConf, with a simpler config file.

TopLevelKeyDesc

Regular top-level key descriptor, with only one level.

TopLevelKeyDescBase

Top-level key descriptor, which defines the top-level key to use in the configuration files.

VariadicLevelKeyDesc

Level key descriptor that allows configuration-source-defined sub-level keys.

Exceptions

ConfigKeyError

Exception raised when a key is not found in the config instance.

DeferredValueComputationError

Raised when computing the value of DeferredValue lead to an exception.

KeyComputationRecursionError

Raised when DerivedKeyDesc.compute_val() is reentered while computing a given key on a configuration instance, or when a DeferredValue callback is reentered.

MissingBaseKeyError

Exception raised when a base key needed to compute a derived key is missing.

TopLevelKeyError

Exception raised when no top-level key matches the expected one in the given configuration file.