rpi-extensions 0.3.19

Rust-native (cdylib) plugin loader + AgentTool adapter for rpi — libloading + spawn_blocking ABI bridge
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

//! Declarative, passive UI panels transported by the existing SetStatus action.
use serde::{Deserialize, Serialize};

#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "kebab-case")]
pub enum PanelAnchor {
    TopLeft,
    TopCenter,
    #[default]
    TopRight,
    LeftCenter,
    Center,
    RightCenter,
    BottomLeft,
    BottomCenter,
    BottomRight,
}

#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "kebab-case")]
pub enum PanelLayout {
    #[default]
    Overlay,
    Sidebar,
}

#[derive(Clone, Debug, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct ExtensionPanel {
    pub version: u32,
    #[serde(default)]
    pub layout: PanelLayout,
    #[serde(default)]
    pub anchor: PanelAnchor,
    #[serde(default)]
    pub offset_x: i32,
    #[serde(default)]
    pub offset_y: i32,
    #[serde(default = "default_width")]
    pub width: usize,
    #[serde(default = "default_height")]
    pub max_height: usize,
    #[serde(default)]
    pub min_screen_width: usize,
    #[serde(default = "default_border")]
    pub border: bool,
    #[serde(default)]
    pub title: String,
    pub lines: Vec<String>,
}
fn default_width() -> usize {
    44
}
fn default_height() -> usize {
    16
}
fn default_border() -> bool {
    true
}
impl ExtensionPanel {
    pub fn validate(&self) -> Result<(), String> {
        if self.version != 1 {
            return Err("unsupported panel version (expected 1)".into());
        }
        if !(4..=240).contains(&self.width)
            || !(1..=80).contains(&self.max_height)
            || self.min_screen_width > 1000
            || self.offset_x.unsigned_abs() > 1000
            || self.offset_y.unsigned_abs() > 1000
        {
            return Err("panel geometry is out of range".into());
        }
        if self.lines.len() > 64
            || self.lines.iter().any(|line| line.len() > 2048)
            || self.title.len() > 256
        {
            return Err("panel content exceeds limits".into());
        }
        Ok(())
    }
    /// Content updates retain the same overlay and its stacking position.
    pub fn same_geometry(&self, other: &Self) -> bool {
        self.layout == other.layout
            && self.anchor == other.anchor
            && self.offset_x == other.offset_x
            && self.offset_y == other.offset_y
            && self.width == other.width
            && self.max_height == other.max_height
    }
}