fornix 0.4.0

Knowledge storage, retrieval, and graph infrastructure for cognitive systems
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! Caching layer for embeddings and LLM responses.
//!
//! Provides a [`CacheAdapter`] trait and implementations for:
//! - [`adapters::MemoryCacheAdapter`] — in-process, TTL-aware (no external deps)
//! - [`adapters::NullCacheAdapter`] — no-op for disabling caching
//! - `adapters::PostgresCacheAdapter` — persistent (stubbed, requires sqlx)
//! - `adapters::RedisCacheAdapter` — persistent (stubbed, requires redis crate)
//!
//! Cache keys are built deterministically via [`key::CacheKey`].
//! Statistics are reported as a typed [`stats::CacheStats`] struct.
//!
//! # Quick start
//!
//! ```rust,no_run
//! use fornix::cache::{CacheConfig, adapters::MemoryCacheAdapter, CacheAdapter};
//!
//! # async fn _doc() {
//! let adapter = MemoryCacheAdapter::connect(CacheConfig::default()).await.unwrap();
//! adapter.set("my-key", b"my-value".to_vec(), None, None).await.unwrap();
//! let value = adapter.get("my-key", None).await.unwrap();
//! assert_eq!(value, Some(b"my-value".to_vec()));
//! # }
//! ```

pub mod adapter;
pub mod adapters;
pub mod config;
pub mod error;
pub mod key;
pub mod stats;

pub use adapter::CacheAdapter;
pub use config::CacheConfig;
pub use error::{Error, Result};
pub use key::CacheKey;
pub use stats::CacheStats;