Struct DecompressedChunkCache 

pub struct DecompressedChunkCache { /* private fields */ }

A shared, bytes-bounded, sharded decompressed-chunk cache.

Implementations

impl DecompressedChunkCache

pub fn with_budget_bytes(total_budget_bytes: usize) -> Self

Create a cache with total_budget_bytes split across DEFAULT_SHARDS shards.

pub fn with_budget_and_shards( total_budget_bytes: usize, shard_count: usize, ) -> Self

Create a cache with total_budget_bytes split across shard_count shards.

shard_count is rounded UP to the next power of two (min 1) so shard selection can mask instead of modulo. Unit tests use shard_count = 1 for deterministic eviction ordering; production uses DEFAULT_SHARDS.

pub fn get(&self, key: &ChunkKey) -> Option<Arc<[u8]>>

Look up a resident chunk. On a hit this bumps recency and returns an Arc::clone (no chunk-sized allocation). On a miss returns None.

pub fn insert(&self, key: ChunkKey, data: Vec<u8>) -> Arc<[u8]>

Insert data under key, returning the resident Arc<[u8]>.

The Vec<u8> is converted to Arc<[u8]> exactly once here; the returned handle and any subsequent get share that one buffer. After insertion the owning shard evicts LRU entries until it is within its byte budget (never evicting the just-inserted entry).

pub fn resident_bytes(&self) -> usize

Total resident decompressed bytes across all shards.

pub fn len(&self) -> usize

Total resident entry count across all shards.

pub fn is_empty(&self) -> bool

Whether the cache currently holds no entries.

pub fn budget_bytes(&self) -> usize

The configured total byte budget (budget_per_shard * shard count).

pub fn hit_count(&self) -> u64

Cumulative cache hits (test/observability instrumentation).

pub fn miss_count(&self) -> u64

Cumulative cache misses (test/observability instrumentation).

Trait Implementations

impl Debug for DecompressedChunkCache

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

Formats the value using the given formatter.

impl Default for DecompressedChunkCache

fn default() -> Self

Returns the “default value” for a type.