zahirscan 0.3.6

Token-efficient content compression for AI analysis using probabilistic template mining
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

use toml::Value as TomlValue;
use toml::map::Map;

/// Deep-merge two TOML values. Base is the default; overlay only overrides keys it provides.
/// For keys not present in overlay, the result keeps base's value. Nested tables are merged
/// recursively with the same rule.
pub(crate) fn deep_merge_toml(base: TomlValue, overlay: TomlValue) -> TomlValue {
    match (base, overlay) {
        (TomlValue::Table(base_map), TomlValue::Table(overlay_map)) => {
            let mut out = base_map;
            for (key, overlay_val) in overlay_map {
                let base_val = out.remove(&key).unwrap_or(TomlValue::Table(Map::new()));
                out.insert(key, deep_merge_toml(base_val, overlay_val));
            }
            TomlValue::Table(out)
        }
        (_, overlay) => overlay,
    }
}

// -----------------------------------------------------------------------------
// Helpers (used by core.rs)
// -----------------------------------------------------------------------------

/// Converts `u64` from TOML to `usize`, saturating on 32-bit targets if the value does not fit.
#[inline]
pub(crate) fn u64_to_usize_min(value: u64, min: u64) -> usize {
    usize::try_from(value.max(min)).unwrap_or(usize::MAX)
}

/// Converts `u64` from TOML to `usize`, saturating on 32-bit targets if the value does not fit.
#[inline]
pub(crate) fn u64_to_usize(value: u64) -> usize {
    usize::try_from(value).unwrap_or(usize::MAX)
}

#[inline]
pub(crate) fn clamp_f64(value: f64, min: f64, max: f64) -> f64 {
    value.clamp(min, max)
}

/// Validate a f64 is in [0.0, 1.0]; return Err with clear message otherwise.
#[macro_export]
macro_rules! validate_range_01 {
    ($self:expr, $field:ident, $name:expr) => {
        if !(0.0..=1.0).contains(&$self.$field) {
            return Err(anyhow::anyhow!(
                "config: {} must be in [0.0, 1.0], got {}",
                $name,
                $self.$field
            ));
        }
    };
}

/// Validate a numeric field is >= min; return Err with clear message otherwise.
#[macro_export]
macro_rules! validate_min {
    ($self:expr, $field:ident, $min:expr, $name:expr) => {
        if $self.$field < $min {
            return Err(anyhow::anyhow!(
                "config: {} must be >= {}, got {}",
                $name,
                $min,
                $self.$field
            ));
        }
    };
}