Struct CacheConfig 

pub struct CacheConfig { /* private fields */ }

Cache configuration.

Controls cache behavior including size limits, persistence, and location.

Default Values

• max_bytes: 50 MB (52,428,800 bytes)
• enable_persistence: true
• cache_root: .sqry-cache (relative to working directory)
• background_writer: true (use background thread for writes)

Environment Variables

Configuration can be overridden via environment variables:

• SQRY_CACHE_MAX_BYTES: Maximum cache size in bytes
• SQRY_CACHE_DISABLE_PERSIST: Set to 1 to disable persistence
• SQRY_CACHE_ROOT: Custom cache directory location
• SQRY_CACHE_POLICY: lru, tiny_lfu, or hybrid eviction policy
• SQRY_CACHE_POLICY_WINDOW: Protected window ratio for hybrid TinyLFU (float, e.g. 0.2)

Examples

use sqry_core::cache::CacheConfig;

// Default configuration
let config = CacheConfig::default();
assert_eq!(config.max_bytes(), 50 * 1024 * 1024); // 50 MB

// Custom configuration
let config = CacheConfig::new()
    .with_max_bytes(100 * 1024 * 1024) // 100 MB
    .with_persistence(false); // Memory-only

Implementations

impl CacheConfig

pub const DEFAULT_MAX_BYTES: u64

Default maximum cache size (50 MB).

pub const DEFAULT_CACHE_ROOT: &'static str = ".sqry-cache"

Default cache root directory.

pub const DEFAULT_POLICY_WINDOW_RATIO: f32 = 0.20

Default protected window ratio for hybrid/tiny LFU policies.

pub const MIN_POLICY_WINDOW_RATIO: f32 = 0.05

Minimum allowed protected window ratio for TinyLFU policies.

pub const MAX_POLICY_WINDOW_RATIO: f32 = 0.95

Maximum allowed protected window ratio for TinyLFU policies.

pub fn new() -> Self

Create a new cache configuration with default values.

Examples

use sqry_core::cache::CacheConfig;

let config = CacheConfig::new();

pub fn from_env() -> Self

Create configuration from environment variables.

Reads configuration from:

• SQRY_CACHE_MAX_BYTES: Override max cache size
• SQRY_CACHE_DISABLE_PERSIST: Set to 1 to disable persistence
• SQRY_CACHE_ROOT: Custom cache directory

Falls back to default values if environment variables are not set.

Examples

use sqry_core::cache::CacheConfig;

// Reads from environment, falls back to defaults
let config = CacheConfig::from_env();

pub fn with_max_bytes(self, max_bytes: u64) -> Self

Set maximum cache size in bytes.

Examples

use sqry_core::cache::CacheConfig;

let config = CacheConfig::new().with_max_bytes(100 * 1024 * 1024); // 100 MB

pub fn with_persistence(self, enable: bool) -> Self

Enable or disable persistent cache to disk.

Examples

use sqry_core::cache::CacheConfig;

// Memory-only cache
let config = CacheConfig::new().with_persistence(false);

pub fn with_cache_root(self, cache_root: PathBuf) -> Self

Set cache root directory.

Examples

use sqry_core::cache::CacheConfig;
use std::path::PathBuf;

let config = CacheConfig::new().with_cache_root(PathBuf::from("/tmp/sqry-cache"));

pub fn with_background_writer(self, enable: bool) -> Self

Enable or disable background writer thread.

When enabled, cache writes are performed asynchronously to avoid blocking query execution. Disable for testing or debugging.

Examples

use sqry_core::cache::CacheConfig;

// Synchronous writes (useful for testing)
let config = CacheConfig::new().with_background_writer(false);

pub fn with_policy_kind(self, kind: CachePolicyKind) -> Self

Override eviction policy kind.

pub fn with_policy_window_ratio(self, ratio: f32) -> Self

Override protected window ratio for hybrid/TinyLFU policies.

pub fn max_bytes(&self) -> u64

Get maximum cache size in bytes.

pub fn is_persistence_enabled(&self) -> bool

Check if persistence is enabled.

pub fn cache_root(&self) -> &PathBuf

Get cache root directory.

pub fn is_background_writer_enabled(&self) -> bool

Check if background writer is enabled.

pub fn policy_kind(&self) -> CachePolicyKind

Get eviction policy kind.

pub fn policy_window_ratio(&self) -> f32

Get protected window ratio for TinyLFU/hybrid policies.

Trait Implementations

impl Clone for CacheConfig

fn clone(&self) -> CacheConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheConfig

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

Formats the value using the given formatter.

impl Default for CacheConfig

fn default() -> Self

Returns the “default value” for a type.