Struct GdsfCacheConfig 

pub struct GdsfCacheConfig {
    pub capacity: NonZeroUsize,
    pub initial_age: f64,
    pub max_size: u64,
}

Configuration for a GDSF (Greedy Dual-Size Frequency) cache.

GDSF assigns a priority to each item based on the formula: Priority = (Frequency / Size) + Global_Age

This makes it ideal for caching variable-sized objects where you want to favor keeping many small popular items over few large items.

Fields

• capacity: Maximum number of entries the cache can hold. Each entry has memory overhead (~64-128 bytes) for keys, pointers, and metadata.
• initial_age: Initial global age value (default: 0.0)
• max_size: Maximum total size in bytes for cached values. Essential for GDSF since the algorithm optimizes based on object sizes. See module docs for guidance.

Sizing Recommendations

Always set meaningful values for both fields:

• In-memory cache: max_size = memory budget for values; capacity = max_size / average_value_size
• Disk-based cache: max_size = disk space allocation; capacity = max_size / average_object_size

Examples

use cache_rs::config::GdsfCacheConfig;
use cache_rs::GdsfCache;
use core::num::NonZeroUsize;

// 10MB cache for variable-sized web responses (~2KB avg)
let config = GdsfCacheConfig {
    capacity: NonZeroUsize::new(5_000).unwrap(),
    initial_age: 0.0,
    max_size: 10 * 1024 * 1024,  // 10MB
};
let cache: GdsfCache<String, Vec<u8>> = GdsfCache::init(config, None);

// 100MB image cache with ~20KB average size
let config = GdsfCacheConfig {
    capacity: NonZeroUsize::new(5_000).unwrap(),
    initial_age: 0.0,
    max_size: 100 * 1024 * 1024,  // 100MB
};
let cache: GdsfCache<String, Vec<u8>> = GdsfCache::init(config, None);

Fields

capacity: NonZeroUsize

Maximum number of key-value pairs the cache can hold. Account for ~64-128 bytes overhead per entry beyond value size.

initial_age: f64

Initial global age value

max_size: u64

Maximum total size in bytes for cached values. Set based on your memory/disk budget. Avoid using u64::MAX.

Trait Implementations

impl Clone for GdsfCacheConfig

fn clone(&self) -> GdsfCacheConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GdsfCacheConfig

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

Formats the value using the given formatter.

impl Copy for GdsfCacheConfig