guardian-db 0.19.0

High-performance, local-first decentralized database built on Rust and Iroh
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

pub mod client;
pub mod config;
pub mod core;
pub mod types;

// Main re-exports for compatibility.
pub use client::IrohClient;
pub use config::ClientConfig;
pub use types::*;

/// Network Core version.
pub const VERSION: &str = "0.1.0";

/// User agent string used for identification.
pub const USER_AGENT: &str = "guardian-db-network-core/0.1.0";

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

    #[tokio::test]
    async fn test_module_initialization() {
        let unique_id = std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .unwrap()
            .as_nanos();
        let config = ClientConfig {
            data_store_path: Some(std::path::PathBuf::from(format!(
                "./tmp/test_init_{}",
                unique_id
            ))),
            ..ClientConfig::development()
        };
        let client = IrohClient::new(config).await;
        assert!(client.is_ok());
        if let Ok(client) = client {
            let _ = client.shutdown().await;
        }
    }

    #[tokio::test]
    async fn test_basic_operations() {
        let unique_id = std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .unwrap()
            .as_nanos();
        let config = ClientConfig {
            data_store_path: Some(std::path::PathBuf::from(format!(
                "./tmp/test_basic_{}",
                unique_id
            ))),
            ..ClientConfig::development()
        };
        let client = IrohClient::new(config).await.unwrap();

        // Test is_online
        assert!(client.is_online().await);

        // Test add_bytes/cat_bytes cycle
        let test_data = "Hello, IrohBackend!".as_bytes().to_vec();

        let response = client.add_bytes(test_data.clone()).await.unwrap();
        assert!(!response.hash.is_empty());

        let buffer = client.cat_bytes(&response.hash).await.unwrap();

        // Note: In development mode the data may be mocked,
        // so we do not perform a strict assertion.
        println!(
            "Retrieved data: {} bytes vs {} bytes expected",
            buffer.len(),
            test_data.len()
        );

        let _ = client.shutdown().await;
    }

    #[tokio::test]
    async fn test_node_info() {
        let unique_id = std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .unwrap()
            .as_nanos();
        let config = ClientConfig {
            data_store_path: Some(std::path::PathBuf::from(format!(
                "./tmp/test_info_{}",
                unique_id
            ))),
            ..ClientConfig::development()
        };
        let client = IrohClient::new(config).await.unwrap();
        let info = client.id().await.unwrap();

        assert!(!info.agent_version.is_empty());
        assert!(info.agent_version.contains("guardian-db"));

        let _ = client.shutdown().await;
    }
}