everruns-cli 0.18.0

Command-line interface for Everruns — run and manage agents from your terminal
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

use anyhow::Result;
use clap::Subcommand;
use serde_json::{Value, json};

use crate::commands::api::ApiClient;
use crate::commands::discovery::{DiscoveryCommands, Resource};
use crate::output::OutputFormat;

#[derive(Subcommand, Debug)]
pub enum PluginsCommands {
    /// List installed plugins
    List,
    /// Get an installed plugin by ID
    Get { id: String },
    /// Install a plugin from a marketplace
    Install {
        marketplace_id: String,
        plugin_name: String,
    },
    /// Uninstall a plugin by ID
    Uninstall { id: String },
}

const PLUGINS: Resource = Resource {
    path: "/plugins",
    collection_key: "plugins",
    empty_message: "No plugins found.",
    columns: &[
        ("ID", "id"),
        ("NAME", "name"),
        ("DESCRIPTION", "description"),
    ],
    detail_fields: &[
        ("ID", "id"),
        ("Name", "name"),
        ("Description", "description"),
        ("Version", "version"),
    ],
};

pub async fn run(
    command: PluginsCommands,
    api_url: &str,
    api_key: &str,
    org_id: Option<&str>,
    format: OutputFormat,
) -> Result<()> {
    match command {
        PluginsCommands::List => {
            run_discovery(DiscoveryCommands::List, api_url, api_key, org_id, format).await
        }
        PluginsCommands::Get { id } => {
            run_discovery(
                DiscoveryCommands::Get { id },
                api_url,
                api_key,
                org_id,
                format,
            )
            .await
        }
        PluginsCommands::Install {
            marketplace_id,
            plugin_name,
        } => {
            let body = install_request(&marketplace_id, &plugin_name);
            let response = ApiClient::new(api_url, api_key, org_id)
                .post("/plugins", Some(&body))
                .await?;
            format.print_value(&response);
            Ok(())
        }
        PluginsCommands::Uninstall { id } => {
            let response = ApiClient::new(api_url, api_key, org_id)
                .delete(&super::discovery::resource_path("/plugins", &id))
                .await?;
            format.print_value(&response);
            Ok(())
        }
    }
}

async fn run_discovery(
    command: DiscoveryCommands,
    api_url: &str,
    api_key: &str,
    org_id: Option<&str>,
    format: OutputFormat,
) -> Result<()> {
    super::discovery::run(command, api_url, api_key, org_id, format, PLUGINS).await
}

fn install_request(marketplace_id: &str, plugin_name: &str) -> Value {
    json!({ "marketplace_id": marketplace_id, "plugin_name": plugin_name })
}

#[cfg(test)]
mod tests {
    use super::install_request;
    use serde_json::json;

    #[test]
    fn install_request_matches_server_contract() {
        assert_eq!(
            install_request("marketplace-id", "plugin-name"),
            json!({
                "marketplace_id": "marketplace-id",
                "plugin_name": "plugin-name"
            })
        );
    }
}