Struct CacheStats 

#[non_exhaustive]
pub struct CacheStats {
    pub hits: u64,
    pub misses: u64,
    pub hit_ratio: f64,
}

Snapshot of a Config’s cache-hit / cache-miss counters.

Returned by Config::cache_stats. The struct is #[non_exhaustive] so the v1.x SemVer contract can add new counter fields (e.g. evictions, insertions, per-shard breakdowns) in MINOR releases without breaking user code.

Stability note for v0.9.5

In v0.9.5 every CacheStats returned by Config::cache_stats has hits = 0, misses = 0, hit_ratio = 0.0. The lock-free cache layer that populates these counters lands in a follow-up v0.9.5 implementation release. The struct is shipping now so the API surface is locked in ahead of the implementation.

Examples

use config_lib::Config;

let cfg = Config::new();
let stats = cfg.cache_stats();
assert_eq!(stats.hits, 0);
assert_eq!(stats.misses, 0);
assert_eq!(stats.hit_ratio, 0.0);

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

hits: u64

Number of cache lookups that resolved to a cached value.

misses: u64

Number of cache lookups that did not find a cached value and fell through to the canonical storage.

hit_ratio: f64

hits / (hits + misses) as an f64 in [0.0, 1.0]. Returns 0.0 when no lookups have happened yet.

Trait Implementations

impl Clone for CacheStats

fn clone(&self) -> CacheStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheStats

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

Formats the value using the given formatter.

impl Copy for CacheStats