Struct OperationConfig 

pub struct OperationConfig {
    pub ttl_override: Option<Duration>,
    pub retry_count: u32,
}

Configuration for per-operation overrides.

This allows you to override TTL and retry behavior for individual cache operations, without affecting the global settings on the CacheExpander.

Setup-Time vs Per-Operation Configuration

• Setup-time configuration: Set once on CacheExpander using with_metrics() or with_ttl_policy(). These affect all operations.
• Per-operation configuration: Use OperationConfig to override settings for a specific cache operation.

Example

use cache_kit::OperationConfig;
use std::time::Duration;

// Override TTL and add retry for this specific operation
let config = OperationConfig::default()
    .with_ttl(Duration::from_secs(300))
    .with_retry(3);

expander.with_config(&mut feeder, &repo, strategy, config).await?;

Fields

ttl_override: Option<Duration>

Override the default TTL for this operation only.

Precedence and Conflict Resolution

When both ttl_override and the expander’s ttl_policy could apply:

• If Some(duration): Use this override (takes precedence)
• If None: Fall back to the expander’s ttl_policy

This allows per-operation exceptions without changing global settings.

Example: Flash Sale Override

use cache_kit::{CacheExpander, OperationConfig, observability::TtlPolicy};
use std::time::Duration;

// Setup: Default 1-hour cache for all entities
let expander = CacheExpander::new(backend)
    .with_ttl_policy(TtlPolicy::Fixed(Duration::from_secs(3600)));

// Normal operation: Uses 1-hour TTL from global policy
expander.with(&mut feeder, &repo, CacheStrategy::Refresh).await?;

// Flash sale: Override to 60 seconds (one-time exception)
let flash_config = OperationConfig::default()
    .with_ttl(Duration::from_secs(60));  // Overrides global 1h policy
expander.with_config(&mut feeder, &repo, CacheStrategy::Refresh, flash_config).await?;

retry_count: u32

Number of retry attempts for this operation (0 = no retry).

If the operation fails, it will be retried up to this many times with exponential backoff.

Implementations

impl OperationConfig

pub fn with_ttl(self, ttl: Duration) -> Self

Override TTL for this operation.

Example

let config = OperationConfig::default()
    .with_ttl(Duration::from_secs(300));

pub fn with_retry(self, count: u32) -> Self

Set retry count for this operation.

Example

let config = OperationConfig::default()
    .with_retry(3);  // Retry up to 3 times on failure

Trait Implementations

impl Clone for OperationConfig

fn clone(&self) -> OperationConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OperationConfig

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

Formats the value using the given formatter.

impl Default for OperationConfig

fn default() -> OperationConfig

Returns the “default value” for a type.