cachekit 0.7.0

High-performance cache primitives with pluggable eviction policies (LRU, LFU, FIFO, 2Q, Clock-PRO, S3-FIFO) and optional metrics.
Documentation
# API Surface

This page maps the major modules and how they fit together.

## Core Modules

- `builder``CacheBuilder` and `CachePolicy`, the unified entrypoint for building caches.
- `policy` — Policy implementations (LRU, LFU, LRU-K, 2Q, Clock, S3-FIFO).
- `ds` — Data structures used by policies (rings, lists, heaps, arenas).
- `stores` — Storage backends for policy metadata and values.
- `traits` — Common cache traits for shared behavior and policy-specific operations.

## Typical Flow

1. Choose a `CachePolicy` variant.
2. Build with `CacheBuilder::new(capacity).build::<K, V>(policy)`.
3. Use the unified `Cache<K, V>` API for standard operations.
4. Drop into `policy::*` or `ds::*` for advanced or policy-specific operations.

## Feature Flags

Policies are gated behind feature flags (e.g. `policy-lru`, `policy-s3-fifo`). Use `default-features = false` and enable only the policies you need. See [Compatibility and Features](compatibility-and-features.md).

## Where to Start

- [Builder overview]../getting-started/integration.md
- [Policy guidance]../policies/README.md
- [Data structures]../policy-ds/README.md