`pynenc.conf.config_client_data_store`¶

Configuration for the ClientDataStore system.

Controls serialization caching, external storage thresholds, and local cache sizes for client-provided data (arguments, results, exceptions).

Key components:

ConfigClientDataStore: Base configuration for all client data store implementations
ConfigClientDataStoreSQLite: SQLite-specific configuration

Module Contents¶

Classes¶

`ConfigClientDataStore`	Configuration for the client data store system.
`ConfigClientDataStoreSQLite`	SQLite-based client data store configuration.

API¶

class pynenc.conf.config_client_data_store.ConfigClientDataStore(config_values: dict[str, Any] | None = None, config_filepath: str | None = None)[source]¶

Bases: pynenc.conf.config_base.ConfigPynencBase

Configuration for the client data store system.

Controls when serialized values are stored externally vs returned inline, local caching behavior, and size monitoring thresholds.

Variables:

disable_client_data_store (ConfigField[bool]) – bool If True, bypass all client data store functionality, returning serialized data directly. Useful for testing or when external storage isn’t needed. Default False.
min_size_to_cache (ConfigField[int]) – Minimum serialized string length (characters) to store externally. Values smaller than this are returned inline as serialized strings. Default 1024 (~1KB) — caching overhead isn’t worth it for smaller values.
max_size_to_cache (ConfigField[int]) – Maximum serialized string length (characters) to store externally. Values larger than this will be stored in chunks. Set to 0 to disable the limit (no maximum). Default 0. Backend implementations may override based on storage constraints.
local_cache_size (ConfigField[int]) – Maximum entries per local LRU cache tier. Default 1024.
warn_threshold (ConfigField[int]) – Log a warning when any single value exceeds this size in bytes. Helps developers identify unexpectedly large arguments/results. Default 10MB (10_485_760 bytes).
compression_enabled (ConfigField[bool]) – Enable compression for externally stored values. Default False. Future feature — reserved for zstd/lz4 compression support.

Initialization

disable_client_data_store: cistell.ConfigField[bool]¶: ‘ConfigField(…)’

min_size_to_cache: cistell.ConfigField[int]¶: ‘ConfigField(…)’

max_size_to_cache: cistell.ConfigField[int]¶: ‘ConfigField(…)’

local_cache_size: cistell.ConfigField[int]¶: ‘ConfigField(…)’

warn_threshold: cistell.ConfigField[int]¶: ‘ConfigField(…)’

compression_enabled: cistell.ConfigField[bool]¶: ‘ConfigField(…)’

class pynenc.conf.config_client_data_store.ConfigClientDataStoreSQLite(config_values: dict[str, Any] | None = None, config_filepath: str | None = None)[source]¶

Bases: pynenc.conf.config_client_data_store.ConfigClientDataStore, pynenc.conf.config_sqlite.ConfigSQLite

SQLite-based client data store configuration.