unistore-cache 0.1.0

//! # unistore-cache
//!
//! 内存缓存能力 - UniStore 能力生态的一部分。
//!
//! ## 功能特性
//!
//! - **LRU 淘汰**: 基于最近最少使用策略自动淘汰
//! - **TTL 支持**: 可设置条目过期时间
//! - **线程安全**: 使用 parking_lot 高性能锁
//! - **统计信息**: 命中率、大小等缓存统计
//! - **泛型支持**: 支持任意 Key-Value 类型
//!
//! ## 快速开始
//!
//! ```rust
//! use unistore_cache::{Cache, CacheConfig};
//! use std::time::Duration;
//!
//! // 创建缓存
//! let cache: Cache<String, String> = Cache::new(CacheConfig::default()
//!     .max_capacity(1000)
//!     .default_ttl(Duration::from_secs(300)));
//!
//! // 存取数据
//! cache.insert("key1".to_string(), "value1".to_string());
//! let value = cache.get(&"key1".to_string());
//! assert_eq!(value, Some("value1".to_string()));
//! ```
//!
//! ## 自定义 TTL
//!
//! ```rust
//! use unistore_cache::{Cache, CacheConfig};
//! use std::time::Duration;
//!
//! let cache: Cache<&str, i32> = Cache::with_defaults();
//!
//! // 使用默认 TTL
//! cache.insert("key1", 100);
//!
//! // 使用自定义 TTL
//! cache.insert_with_ttl("key2", 200, Some(Duration::from_secs(60)));
//!
//! // 永不过期
//! cache.insert_with_ttl("key3", 300, None);
//! ```
//!
//! ## Get or Insert
//!
//! ```rust
//! use unistore_cache::Cache;
//!
//! let cache: Cache<&str, String> = Cache::with_defaults();
//!
//! // 如果不存在则计算并插入
//! let value = cache.get_or_insert_with("expensive_key", || {
//!     // 昂贵的计算...
//!     "computed_value".to_string()
//! });
//! ```
//!
//! ## 统计信息
//!
//! ```rust
//! use unistore_cache::Cache;
//!
//! let cache: Cache<&str, i32> = Cache::with_defaults();
//! cache.insert("key1", 42);
//! cache.get(&"key1");
//! cache.get(&"key2"); // miss
//!
//! let stats = cache.stats();
//! println!("命中率: {:.2}%", stats.hit_rate() * 100.0);
//! ```

// === 内部模块 ===
mod cache;
mod config;
mod deps;
mod entry;
mod error;
mod stats;

// === 对外接口（SDK）===
pub use cache::Cache;
pub use config::CacheConfig;
pub use entry::CacheEntry;
pub use error::CacheError;
pub use stats::{CacheStats, CacheStatsSnapshot};