velesdb-core 1.6.0

High-performance vector database engine written in Rust
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

//! Caching layer for `VelesDB` (SOTA 2026).
//!
//! Based on arXiv:2310.11703v2 recommendations:
//! - LRU cache for metadata-only collections
//! - Bloom filter for existence checks
//! - Cache statistics and monitoring
//!
//! # Thread-Safety & Lock Ordering
//!
//! All structures are thread-safe via `parking_lot::RwLock`.
//!
//! **Lock Hierarchy (acquire in this order to prevent deadlocks):**
//! 1. `BloomFilter.bits` (`RwLock`)
//! 2. `BloomFilter.count` (`RwLock`)
//! 3. `LruCache.inner` (`RwLock`)

mod bloom;
#[cfg(test)]
mod bloom_tests;
mod lockfree;
#[cfg(test)]
mod lockfree_tests;
mod lru;
#[cfg(feature = "persistence")]
pub mod plan_cache;
#[cfg(all(test, feature = "persistence"))]
mod plan_cache_tests;

pub use bloom::BloomFilter;
pub use lockfree::{LockFreeCacheStats, LockFreeLruCache};
pub use lru::{CacheStats, LruCache};
#[cfg(feature = "persistence")]
pub use plan_cache::{CompiledPlan, CompiledPlanCache, PlanCacheMetrics, PlanKey};

#[cfg(test)]
mod deadlock_tests;
#[cfg(test)]
mod lru_optimization_tests;
#[cfg(test)]
mod performance_tests;
#[cfg(test)]
mod tests;