fleche.config

Configuration system for fleche.

Example cache.toml:

[default] cache = “mycache” metadata = [“Runtime”, “CallInfo”]

[mycache] values.type = “Memory” calls.type = “Memory”

[transient] values.type = “CloudpickleFile” values.root = “.fleche/values” calls.type = “CloudpickleFile” calls.root = “.fleche/calls”

[global] values.type = “BagOfHoldingH5File” values.root = “~/.fleche/values” calls.type = “CloudpickleFile” calls.root = “~/.fleche/calls”

Attributes

logger
_live_caches
_STORAGE_NAME_MAPPING
_STORAGE_CLASS_TO_NAME

Functions

_load_config(→ dict[str, Any])
_get_config_path(→ pathlib.Path | None)
load_default_metadata()	Load the default metadata from the configuration file.
storage_from_config(…)	Construct a StorageBackend from a config dict.
storage_to_config(→ dict[str, Any])	Convert a Storage instance to a config dict (inverse of storage_from_config).
cache_from_config(→ fleche.caches.BaseCache)	Construct a BaseCache from a config dict or list.
cache_to_config(→ dict[str, Any] | list[dict[str, Any]])	Convert a BaseCache to a config dict or list.
_create_cache(→ fleche.caches.Cache)
load_cache_config(→ fleche.caches.Cache)	Load a cache from the configuration file.

Module Contents

fleche.config.logger

fleche.config._live_caches: dict[str, fleche.caches.Cache]

fleche.config._load_config(path: pathlib.Path) → dict[str, Any]

fleche.config._get_config_path() → pathlib.Path | None

fleche.config.load_default_metadata()

Load the default metadata from the configuration file.

fleche.config._STORAGE_NAME_MAPPING

fleche.config._STORAGE_CLASS_TO_NAME: dict[type, str]

fleche.config.storage_from_config(d: dict[str, Any], type: Literal['call']) → fleche.storage.CallStorage

fleche.config.storage_from_config(d: dict[str, Any], type: Literal['value']) → fleche.storage.ValueStorage

Construct a StorageBackend from a config dict.

The dict must contain a "type" key (case-sensitive) and any additional parameters required by that storage backend. The input dict is not mutated.

fleche.config.storage_to_config(s: fleche.storage.ValueStorage | fleche.storage.CallStorage) → dict[str, Any]

Convert a Storage instance to a config dict (inverse of storage_from_config).

The returned dict contains a "type" key and any additional parameters needed to reconstruct the storage via storage_from_config().

fleche.config.cache_from_config(d: dict[str, Any] | list[dict[str, Any]]) → fleche.caches.BaseCache

Construct a BaseCache from a config dict or list.

The cache type is determined implicitly from the shape of the input:

• A list of dicts is treated as a CacheStack, with each element processed recursively.

• A dict containing a max_size key creates a SizeLimitedCache.

• A dict containing read_only: true wraps the resulting cache in a ReadOnlyCache.

• Otherwise a plain Cache is created.

The input dict is not mutated.

Examples:

# Plain cache with in-memory storage
cache_from_config({
    "values": {"type": "memory"},
    "calls": {"type": "memory"},
})

# Size-limited cache — presence of max_size selects SizeLimitedCache
cache_from_config({
    "values": {"type": "memory"},
    "calls": {"type": "memory"},
    "max_size": 100,
})

# Read-only cache — read_only: true wraps the cache in ReadOnlyCache
cache_from_config({
    "values": {"type": "memory"},
    "calls": {"type": "memory"},
    "read_only": True,
})

# CacheStack — a list of dicts is implicitly treated as a stack
cache_from_config([
    {"values": {"type": "memory"}, "calls": {"type": "memory"}},
    {"values": {"type": "void"}, "calls": {"type": "void"}},
])

fleche.config.cache_to_config(c: fleche.caches.BaseCache) → dict[str, Any] | list[dict[str, Any]]

Convert a BaseCache to a config dict or list.

This is the inverse of cache_from_config(). The output can be round-tripped back via cache_from_config(cache_to_config(cache)).

• Cache → dict with "values" and "calls"

• SizeLimitedCache → same dict plus "max_size"

• ReadOnlyCache wrapping a Cache or SizeLimitedCache → inner cache dict with "read_only": True

• CacheStack → list of dicts

Raises:

ValueError – for unsupported cache types or unsupported ReadOnlyCache inner types.

fleche.config._create_cache(cache_config: dict[str, Any]) → fleche.caches.Cache

fleche.config.load_cache_config(name: str | None = None) → fleche.caches.Cache

Load a cache from the configuration file.

If name is None, the default cache is loaded. The names ‘memory’ and ‘void’ are special-cased to return a transient in-memory cache and a no-op cache respectively.

Note: The Tags metadata cannot be configured from the config file.