aam 0.3.0

AAM CLI is a CLI for AAM (learn more about AAM at https://aam.ininids.in.rs)
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

// SPDX-FileCopyrightText: 2026 Nikita Goncharov
// SPDX-License-Identifier: GPL-3.0-or-later

use anyhow::Result;
use std::fmt::Debug;

pub trait Plugin: Debug + Send + Sync {
    fn name(&self) -> &str;
    fn description(&self) -> &str;

    // Lifecycle hooks
    /// # Errors
    /// Returns an error if plugin initialization fails.
    fn on_init(&mut self) -> Result<()> {
        Ok(())
    }
    /// # Errors
    /// Returns an error if command handling fails.
    fn on_command(&mut self, _command: &str, _args: &[&str]) -> Result<bool> {
        Ok(false)
    } // Returns true if handled
}

#[derive(Default)]
pub struct PluginManager {
    plugins: Vec<Box<dyn Plugin>>,
}

impl PluginManager {
    #[must_use]
    pub fn new() -> Self {
        Self {
            plugins: Vec::new(),
        }
    }

    /// # Errors
    /// Returns an error if the plugin fails to initialize.
    pub fn register<P: Plugin + 'static>(&mut self, mut plugin: P) -> Result<()> {
        plugin.on_init()?;
        self.plugins.push(Box::new(plugin));
        Ok(())
    }

    /// # Errors
    /// Returns an error if command handling fails.
    pub fn handle_command(&mut self, command: &str, args: &[&str]) -> Result<bool> {
        for plugin in &mut self.plugins {
            if plugin.on_command(command, args)? {
                return Ok(true);
            }
        }
        Ok(false)
    }
}