gveditor-core-api 0.1.7

Graviton Core API
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

use std::path::PathBuf;
use std::sync::Arc;

use tokio::sync::mpsc::{channel, Sender};
use tokio::sync::Mutex;

use crate::extensions::base::Extension;
use crate::messaging::Messages;
use crate::{Manifest, ManifestInfo};

use super::base::ExtensionInfo;
use super::client::ExtensionClient;

/// Manage a group of extensions
#[derive(Clone)]
pub struct ExtensionsManager {
    pub extensions: Vec<LoadedExtension>,
    pub sender: Sender<Messages>,
    pub settings_path: Option<PathBuf>,
}

impl Default for ExtensionsManager {
    fn default() -> Self {
        let (sender, _) = channel::<Messages>(1);
        Self {
            extensions: Vec::new(),
            sender,
            settings_path: None,
        }
    }
}

impl ExtensionsManager {
    pub fn new(sender: Sender<Messages>, settings_path: Option<PathBuf>) -> Self {
        Self {
            extensions: Vec::new(),
            sender,
            settings_path,
        }
    }

    pub async fn load_extension_from_entry(
        &mut self,
        entry: fn(&mut Self, ExtensionClient, u8),
        info: ManifestInfo,
        state_id: u8,
    ) -> &mut ExtensionsManager {
        let client = ExtensionClient::new(
            &info.extension.id,
            &info.extension.name,
            self.sender.clone(),
            self.settings_path.clone(),
        );
        entry(self, client, state_id);
        self.extensions
            .push(LoadedExtension::ManifestBuiltin { info });
        self
    }

    /// Load a extension
    pub fn register(&mut self, parent_id: &str, plugin: Box<dyn Extension + Send>) {
        let info = plugin.get_info();
        let plugin = Arc::new(Mutex::new(plugin));
        self.extensions.push(LoadedExtension::ExtensionInstance {
            plugin,
            info,
            parent_id: parent_id.to_string(),
        });
    }
}

/// Extension wrappers
#[derive(Clone)]
pub enum LoadedExtension {
    // Loaded from the source code itself, not dinamically, e.g git-for-graviton (because it has a manifest but not a path)
    ManifestBuiltin {
        info: ManifestInfo,
    },
    // Loaded from a manifest file dinamically, e.g any third-party extension
    ManifestFile {
        manifest: Manifest,
    },
    // Loaded from a extension
    ExtensionInstance {
        plugin: Arc<Mutex<Box<dyn Extension + Send>>>,
        info: ExtensionInfo,
        parent_id: String,
    },
}