Enum CacheStrategy 

pub enum CacheStrategy {
    Fresh,
    Refresh,
    Invalidate,
    Bypass,
}

Strategy enum controlling cache fetch/invalidation behavior.

Replaces boolean flags with explicit, type-safe options.

Examples

use cache_kit::strategy::CacheStrategy;

// Use cache only
let _strategy = CacheStrategy::Fresh;

// Try cache, fallback to database
let _strategy = CacheStrategy::Refresh;

// Clear cache and refresh from database
let _strategy = CacheStrategy::Invalidate;

// Skip cache entirely
let _strategy = CacheStrategy::Bypass;

Variants

Fresh

Fresh: Try cache only, no fallback to database.

Use when: You know data should be in cache, and miss is an error condition.

Flow:

1. Check cache
2. If hit: return cached value
3. If miss: return None (don’t hit database)

Refresh

Refresh: Try cache first, fallback to database on miss.

Use when: Default behavior, prefer cache but ensure data availability.

Flow:

1. Check cache
2. If hit: return cached value
3. If miss: fetch from database
4. Store in cache
5. Return value

Invalidate

Invalidate: Mark cache as invalid and refresh from database.

Use when: You know cache is stale and need fresh data. Typical use: After update/mutation operations.

Flow:

1. Delete from cache
2. Fetch from database
3. Store in cache
4. Return value

Bypass

Bypass: Ignore cache entirely, always fetch from database.

Use when: Cache is temporarily disabled or for specific read-through scenarios.

Flow:

1. Fetch from database
2. Store in cache (for others)
3. Return value

Trait Implementations

impl Clone for CacheStrategy

fn clone(&self) -> CacheStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheStrategy

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

Formats the value using the given formatter.

impl Default for CacheStrategy

fn default() -> CacheStrategy

Returns the “default value” for a type.

impl Display for CacheStrategy

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

Formats the value using the given formatter.

impl PartialEq for CacheStrategy

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CacheStrategy

impl StructuralPartialEq for CacheStrategy