cognis 0.2.1

LLM application framework built on cognis-core
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
37
38
39
40
41
42
43
44
45

//! Key-value store implementations.
//!
//! This module provides several [`Store`] implementations for persisting
//! arbitrary byte data:
//!
//! - [`InMemoryStore`] — thread-safe in-memory store with optional TTL-based expiration
//! - [`FileStore`] — filesystem-backed store that persists entries as individual files
//! - [`NamespacedStore`] — wraps any `Store` and prefixes keys for isolation
//! - [`LayeredStore`] — read-through cache that checks a fast store first and falls back to a slower backing store

pub mod docstore;
pub mod file;
pub mod in_memory;
pub mod layered;
pub mod namespaced;

pub use file::FileStore;
pub use in_memory::InMemoryStore;
pub use layered::LayeredStore;
pub use namespaced::NamespacedStore;

use cognis_core::error::Result;

/// A synchronous key-value store trait for byte data.
///
/// All implementations must be thread-safe (`Send + Sync`).
pub trait Store: Send + Sync {
    /// Retrieve the value associated with `key`, or `None` if absent.
    fn get(&self, key: &str) -> Result<Option<Vec<u8>>>;

    /// Store `value` under `key`, overwriting any previous value.
    fn set(&self, key: &str, value: &[u8]) -> Result<()>;

    /// Delete the entry for `key`. Returns `true` if the key existed.
    fn delete(&self, key: &str) -> Result<bool>;

    /// Check whether `key` exists in the store.
    fn exists(&self, key: &str) -> bool;

    /// Return all keys currently in the store.
    fn keys(&self) -> Result<Vec<String>>;

    /// Remove all entries from the store.
    fn clear(&self) -> Result<()>;
}