horon-engine 0.5.0

Hyperbolic tree tensor engine - hierarchical data storage with depth-independent lookups
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

//! init.rs - Initialization Module for horon-engine storage
//!
//! Provides functions for initializing and managing
//! hyperbolic tree tensor (HTT) storage instances.

use log::info;

use super::storage::HTTStorage;
use super::config::HTTStorageConfig;
use super::tree_tensor::{SharedHTT, HyperbolicTreeTensor, IntegrationResult};

/// Initialize HTT storage with a configuration.
pub fn initialize_htt_storage(config: HTTStorageConfig) -> IntegrationResult<HTTStorage> {
    info!("Initializing HTT storage components");

    let storage = HTTStorage::new(config);

    info!("HTT storage components initialized");
    Ok(storage)
}

/// Execute a function with access to a shared HTT instance.
///
/// No locking needed: all HyperbolicTreeTensor methods take `&self`
/// with fine-grained interior mutability (DashMap, Mutex, RwLock).
pub fn with_htt<R, F>(
    htt: &SharedHTT,
    f: F,
) -> IntegrationResult<R>
where
    F: FnOnce(&HyperbolicTreeTensor) -> IntegrationResult<R>,
{
    f(htt)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_htt_initialization() {
        let config = HTTStorageConfig::default();
        let result = initialize_htt_storage(config);
        assert!(result.is_ok());

        let storage = result.unwrap();
        assert!(storage.exists("/"));
    }

    #[test]
    fn test_htt_with_custom_config() {
        let config = HTTStorageConfig::new(
            8,
            2000,
            200,
            None,
            120,
            false,
        );
        let result = initialize_htt_storage(config);
        assert!(result.is_ok());
    }
}