aumate 0.2.8

Cross-platform desktop automation library with GUI support
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

//! Widget event types

/// Unique identifier for widgets
pub type WidgetId = String;

/// Events that widgets can emit
#[derive(Debug, Clone, PartialEq)]
pub enum WidgetEvent {
    /// Button was clicked
    ButtonClick { id: WidgetId },

    /// Text input value changed
    TextChanged { id: WidgetId, value: String },

    /// Text input submitted (Enter pressed)
    TextSubmit { id: WidgetId, value: String },

    /// Checkbox state changed
    CheckboxChanged { id: WidgetId, checked: bool },

    /// Slider value changed
    SliderChanged { id: WidgetId, value: f32 },

    /// Widget gained focus
    FocusGained { id: WidgetId },

    /// Widget lost focus
    FocusLost { id: WidgetId },

    /// Mouse entered widget area
    MouseEnter { id: WidgetId },

    /// Mouse left widget area
    MouseLeave { id: WidgetId },

    /// Dropdown selection changed
    SelectionChanged { id: WidgetId, index: usize, value: String },

    /// Radio button selection changed
    RadioChanged { id: WidgetId, index: usize, value: String },

    /// Tab selection changed
    TabChanged { id: WidgetId, index: usize, label: String },

    /// Link was clicked
    LinkClicked { id: WidgetId },

    /// SelectableLabel selection state changed
    SelectableLabelChanged { id: WidgetId, selected: bool },

    /// DragValue value changed
    DragValueChanged { id: WidgetId, value: f64 },

    /// Color picker value changed
    ColorChanged { id: WidgetId, color: [u8; 4] },

    /// Hyperlink was clicked (with URL)
    HyperlinkClicked { id: WidgetId, url: String },

    /// File dialog completed
    FileDialogCompleted { id: WidgetId, paths: Vec<String>, cancelled: bool },

    /// Font selection changed
    FontChanged { id: WidgetId, family: String },
}

impl WidgetEvent {
    /// Get the widget ID associated with this event
    pub fn widget_id(&self) -> &WidgetId {
        match self {
            WidgetEvent::ButtonClick { id } => id,
            WidgetEvent::TextChanged { id, .. } => id,
            WidgetEvent::TextSubmit { id, .. } => id,
            WidgetEvent::CheckboxChanged { id, .. } => id,
            WidgetEvent::SliderChanged { id, .. } => id,
            WidgetEvent::FocusGained { id } => id,
            WidgetEvent::FocusLost { id } => id,
            WidgetEvent::MouseEnter { id } => id,
            WidgetEvent::MouseLeave { id } => id,
            WidgetEvent::SelectionChanged { id, .. } => id,
            WidgetEvent::RadioChanged { id, .. } => id,
            WidgetEvent::TabChanged { id, .. } => id,
            WidgetEvent::LinkClicked { id } => id,
            WidgetEvent::SelectableLabelChanged { id, .. } => id,
            WidgetEvent::DragValueChanged { id, .. } => id,
            WidgetEvent::ColorChanged { id, .. } => id,
            WidgetEvent::HyperlinkClicked { id, .. } => id,
            WidgetEvent::FileDialogCompleted { id, .. } => id,
            WidgetEvent::FontChanged { id, .. } => id,
        }
    }

    /// Get the event type name as a string
    pub fn event_type(&self) -> &'static str {
        match self {
            WidgetEvent::ButtonClick { .. } => "button_click",
            WidgetEvent::TextChanged { .. } => "text_changed",
            WidgetEvent::TextSubmit { .. } => "text_submit",
            WidgetEvent::CheckboxChanged { .. } => "checkbox_changed",
            WidgetEvent::SliderChanged { .. } => "slider_changed",
            WidgetEvent::FocusGained { .. } => "focus_gained",
            WidgetEvent::FocusLost { .. } => "focus_lost",
            WidgetEvent::MouseEnter { .. } => "mouse_enter",
            WidgetEvent::MouseLeave { .. } => "mouse_leave",
            WidgetEvent::SelectionChanged { .. } => "selection_changed",
            WidgetEvent::RadioChanged { .. } => "radio_changed",
            WidgetEvent::TabChanged { .. } => "tab_changed",
            WidgetEvent::LinkClicked { .. } => "link_clicked",
            WidgetEvent::SelectableLabelChanged { .. } => "selectable_label_changed",
            WidgetEvent::DragValueChanged { .. } => "drag_value_changed",
            WidgetEvent::ColorChanged { .. } => "color_changed",
            WidgetEvent::HyperlinkClicked { .. } => "hyperlink_clicked",
            WidgetEvent::FileDialogCompleted { .. } => "file_dialog_completed",
            WidgetEvent::FontChanged { .. } => "font_changed",
        }
    }
}

/// Dialog result for modal dialogs
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum DialogResult {
    /// User clicked OK/Confirm
    Ok,
    /// User clicked Cancel/dismissed
    Cancel,
    /// User selected a custom option
    Custom(String),
}

/// File dialog result
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct FileDialogResult {
    /// Selected file path(s), empty if cancelled
    pub paths: Vec<String>,
    /// Whether the dialog was cancelled
    pub cancelled: bool,
}

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

    #[test]
    fn test_widget_event_id() {
        let event = WidgetEvent::ButtonClick { id: "btn1".to_string() };
        assert_eq!(event.widget_id(), "btn1");
        assert_eq!(event.event_type(), "button_click");
    }

    #[test]
    fn test_text_changed_event() {
        let event =
            WidgetEvent::TextChanged { id: "input1".to_string(), value: "hello".to_string() };
        assert_eq!(event.widget_id(), "input1");
        if let WidgetEvent::TextChanged { value, .. } = event {
            assert_eq!(value, "hello");
        }
    }
}