zipora 3.1.7

High-performance Rust implementation providing advanced data structures and compression algorithms with memory safety guarantees. Features LRU page cache, sophisticated caching layer, fiber-based concurrency, real-time compression, secure memory pools, SIMD optimizations, and complete C FFI for migration from C++.
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
100
101
102
103
104
105
106
107
108
109
110
111

//! Cache configuration for performance optimization.

use super::{Config, parse_env_bool, parse_env_var};
use crate::error::{Result, ZiporaError};
#[cfg(feature = "serde")]
use serde::{Deserialize, Serialize};
use std::path::Path;

/// Cache configuration placeholder.
#[derive(Debug, Clone, PartialEq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct CacheConfig {
    /// Cache size in bytes
    pub size: usize,
    /// Enable cache prefetching
    pub enable_prefetching: bool,
    /// Cache line size
    pub line_size: usize,
}

impl Default for CacheConfig {
    fn default() -> Self {
        Self {
            size: 16 * 1024 * 1024,
            enable_prefetching: true,
            line_size: 64,
        }
    }
}

impl Config for CacheConfig {
    fn validate(&self) -> Result<()> {
        if self.size == 0 {
            return Err(ZiporaError::configuration(
                "size must be greater than 0".to_string(),
            ));
        }
        Ok(())
    }

    fn from_env_with_prefix(prefix: &str) -> Result<Self> {
        let mut config = Self::default();
        config.size = parse_env_var(&format!("{}CACHE_SIZE", prefix), config.size);
        config.enable_prefetching = parse_env_bool(
            &format!("{}CACHE_PREFETCHING", prefix),
            config.enable_prefetching,
        );
        config.line_size = parse_env_var(&format!("{}CACHE_LINE_SIZE", prefix), config.line_size);
        config.validate()?;
        Ok(config)
    }

    fn performance_preset() -> Self {
        Self {
            size: 64 * 1024 * 1024,
            enable_prefetching: true,
            line_size: 64,
        }
    }

    fn memory_preset() -> Self {
        Self {
            size: 4 * 1024 * 1024,
            enable_prefetching: false,
            line_size: 64,
        }
    }

    fn realtime_preset() -> Self {
        Self {
            size: 32 * 1024 * 1024,
            enable_prefetching: true,
            line_size: 64,
        }
    }

    fn save_to_file<P: AsRef<Path>>(&self, path: P) -> Result<()> {
        #[cfg(feature = "serde")]
        {
            let serialized = serde_json::to_string_pretty(self).map_err(|e| {
                ZiporaError::configuration(format!("Failed to serialize cache config: {}", e))
            })?;
            std::fs::write(path, serialized).map_err(|e| {
                ZiporaError::configuration(format!("Failed to write cache config file: {}", e))
            })?;
            Ok(())
        }
        #[cfg(not(feature = "serde"))]
        Err(crate::error::ZiporaError::invalid_operation(
            "Requires serde feature",
        ))
    }

    fn load_from_file<P: AsRef<Path>>(path: P) -> Result<Self> {
        #[cfg(feature = "serde")]
        {
            let content = std::fs::read_to_string(path).map_err(|e| {
                ZiporaError::configuration(format!("Failed to read cache config file: {}", e))
            })?;
            let config: Self = serde_json::from_str(&content).map_err(|e| {
                ZiporaError::configuration(format!("Failed to parse cache config file: {}", e))
            })?;
            config.validate()?;
            Ok(config)
        }
        #[cfg(not(feature = "serde"))]
        Err(crate::error::ZiporaError::invalid_operation(
            "Requires serde feature",
        ))
    }
}