Struct DataStoreConfig 

pub struct DataStoreConfig {
    pub max_entries: usize,
    pub max_entry_size: usize,
    pub default_ttl: Option<Duration>,
    pub max_ttl: Option<Duration>,
    pub enable_metrics: bool,
    pub memory_alert_threshold: f64,
}

Configuration for the DataStore component.

Controls storage limits, TTL behavior, capacity management, and metrics.

TTL Semantics

• default_ttl: None means entries without explicit TTL will effectively never expire. The implementation uses an internal sentinel cap of 10 years (not user-configurable).
• max_ttl: None means no user-configured upper limit on TTL values. The implementation uses an internal sentinel cap of 10 years (not user-configurable).
• If both are Some, the effective TTL will always respect max_ttl constraints

Examples

use std::time::Duration;
use cedarling::DataStoreConfig;

// No configured expiration (uses internal long sentinel TTL)
let config = DataStoreConfig {
    default_ttl: None,  // No automatic expiration
    max_ttl: None,      // No user-configured upper limit
    ..Default::default()
};

// All entries expire after 5 minutes by default, max 1 hour
// When both are Some, max_ttl constrains the effective TTL
let config = DataStoreConfig {
    default_ttl: Some(Duration::from_secs(300)),  // 5 minutes
    max_ttl: Some(Duration::from_secs(3600)),     // 1 hour (constrains effective TTL)
    ..Default::default()
};

Fields

max_entries: usize

Maximum number of data entries (0 = unlimited)

max_entry_size: usize

Maximum size per entry in bytes (0 = unlimited)

default_ttl: Option<Duration>

Default TTL for entries without explicit expiration. None means entries effectively never expire. The implementation uses an internal sentinel cap of 10 years (not user-configurable).

max_ttl: Option<Duration>

Maximum allowed TTL. None means no user-configured upper limit on TTL values. The implementation uses an internal sentinel cap of 10 years (not user-configurable).

enable_metrics: bool

Enable metrics tracking (access counts, timestamps)

memory_alert_threshold: f64

Memory usage alert threshold as a percentage (0.0-100.0). When capacity usage exceeds this threshold, an alert is triggered. Default: 80.0 (80%)

Implementations

impl DataStoreConfig

pub fn validate(&self) -> Result<(), ConfigValidationError>

Validate the configuration for consistency.

Returns ConfigValidationError when default_ttl exceeds max_ttl (if both are set) or when memory_alert_threshold is outside the range 0.0..=100.0.

Trait Implementations

impl Clone for DataStoreConfig

fn clone(&self) -> DataStoreConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DataStoreConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DataStoreConfig

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for DataStoreConfig

fn eq(&self, other: &DataStoreConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DataStoreConfig