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

//! Controller feature trait definitions

use super::context::ControllerContext;
use super::types::TabInfo;
use crate::error::Result;
use std::path::PathBuf;

/// Trait for controller features that can be registered and rendered as tabs.
///
/// Each feature implements this trait to integrate with the controller's
/// dynamic tab system. Features are responsible for:
/// - Providing tab information for navigation
/// - Rendering their UI section
/// - Handling lifecycle events (activate/deactivate)
/// - Processing async callbacks in update()
pub trait ControllerFeature: Send {
    /// Unique feature identifier
    fn id(&self) -> &'static str;

    /// Tab information for navigation display
    fn tab_info(&self) -> TabInfo;

    /// Render the feature's UI section.
    /// Called each frame when this feature's tab is active.
    fn render(&mut self, ui: &mut egui::Ui, ctx: &mut ControllerContext);

    /// Called when this tab becomes active.
    /// Use for lazy initialization or refresh.
    fn on_activate(&mut self, _ctx: &mut ControllerContext) {}

    /// Called when switching away from this tab.
    /// Use for cleanup or saving state.
    fn on_deactivate(&mut self, _ctx: &mut ControllerContext) {}

    /// Called each frame for all features (even inactive ones).
    /// Use for processing async task callbacks.
    fn update(&mut self, _ctx: &mut ControllerContext) {}

    /// Initialize the feature. Called once at startup.
    fn initialize(&mut self, _ctx: &mut ControllerContext) -> Result<()> {
        Ok(())
    }

    /// Cleanup on application shutdown.
    fn shutdown(&mut self) {}
}

/// Trait for features with persistent configuration state.
///
/// Provides a uniform interface for saving and loading feature configs,
/// typically to files in ~/.aumate/
pub trait FeatureState: Sized {
    /// Load state from the default config file
    fn load() -> Result<Self>;

    /// Save state to the default config file
    fn save(&self) -> Result<()>;

    /// Get the config file path
    fn config_path() -> PathBuf;

    /// Load with fallback to default on error
    fn load_or_default() -> Self
    where
        Self: Default,
    {
        Self::load().unwrap_or_default()
    }
}