logic-mesh 1.0.0

Control logic engine using event based and reactive blocks 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
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

// Copyright (c) 2022-2026, Radu Racariu.

use uuid::Uuid;

use crate::base::{
    block::{Block, BlockDesc, BlockProps, BlockState},
    input::{InputProps, input_reader::InputReader},
    output::Output,
};
use crate::blocks::utils::{input_as_number, input_as_number_matching};

use libhaystack::val::{Number, kind::HaystackKind};

use crate::{blocks::InputImpl, blocks::OutputImpl};

/// Clamp the input to the inclusive range `[min..max]`. If `min > max`
/// the bounds are swapped so the block is still well-defined.
///
/// `min` and `max` are read in the same unit as `in`; bounds with a
/// compatible unit are converted, bounds without a unit are taken
/// as-is. The output carries the unit of `in`.
#[block]
#[derive(BlockProps, Debug)]
#[category = "control"]
pub struct Clamp {
    #[input(name = "in", kind = "Number")]
    pub input: InputImpl,
    #[input(kind = "Number")]
    pub min: InputImpl,
    #[input(kind = "Number")]
    pub max: InputImpl,
    #[output(kind = "Number")]
    pub out: OutputImpl,
}

impl Block for Clamp {
    async fn execute(&mut self) {
        self.read_inputs_until_ready().await;

        let n = match input_as_number(&self.input) {
            Some(n) => n,
            None => return,
        };
        let lo = match input_as_number_matching(&self.min, n.unit) {
            Some(v) => v,
            None => return,
        };
        let hi = match input_as_number_matching(&self.max, n.unit) {
            Some(v) => v,
            None => return,
        };
        let (lo, hi) = if lo <= hi { (lo, hi) } else { (hi, lo) };

        let value = n.value.clamp(lo, hi);
        self.out.set(match n.unit {
            Some(u) => Number::make_with_unit(value, u).into(),
            None => value.into(),
        });
    }
}

#[cfg(test)]
mod test {

    use libhaystack::val::Value;

    use crate::{
        base::block::Block, base::block::test_utils::write_block_inputs, blocks::control::Clamp,
    };

    async fn run(input: f64, min: f64, max: f64) -> f64 {
        let mut block = Clamp::new();
        write_block_inputs([
            (&mut block.input, input),
            (&mut block.min, min),
            (&mut block.max, max),
        ])
        .await;
        block.execute().await;
        match block.out.value {
            Value::Number(n) => n.value,
            _ => panic!("expected number"),
        }
    }

    #[tokio::test]
    async fn test_clamp_within() {
        assert_eq!(run(5.0, 0.0, 10.0).await, 5.0);
    }

    #[tokio::test]
    async fn test_clamp_high() {
        assert_eq!(run(15.0, 0.0, 10.0).await, 10.0);
    }

    #[tokio::test]
    async fn test_clamp_low() {
        assert_eq!(run(-5.0, 0.0, 10.0).await, 0.0);
    }

    #[tokio::test]
    async fn test_clamp_swapped_bounds() {
        // min > max → bounds get swapped so the block stays well-defined
        assert_eq!(run(5.0, 10.0, 0.0).await, 5.0);
    }
}