dsc-rs 0.10.15

Discourse CLI tool for managing multiple Discourse forums: track installs, run upgrades over SSH, manage emojis, sync topics and categories as Markdown, and more.
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

use crate::api::DiscourseClient;
use crate::cli::ListFormat;
use crate::commands::common::{ensure_api_credentials, select_discourse};
use crate::config::Config;
use anyhow::Result;

pub fn api_key_list(
    config: &Config,
    discourse_name: &str,
    format: ListFormat,
) -> Result<()> {
    let discourse = select_discourse(config, Some(discourse_name))?;
    ensure_api_credentials(discourse)?;
    let client = DiscourseClient::new(discourse)?;
    let keys = client.list_api_keys()?;

    match format {
        ListFormat::Text => {
            if keys.is_empty() {
                println!("No API keys found.");
                return Ok(());
            }
            let desc_width = keys
                .iter()
                .map(|k| k.description.as_deref().unwrap_or("-").len())
                .max()
                .unwrap_or(0)
                .max(11);
            for k in &keys {
                let desc = k.description.as_deref().unwrap_or("-");
                let user = k.username.as_deref().unwrap_or("(all-users)");
                let last = k.last_used_at.as_deref().unwrap_or("never");
                let status = if k.revoked_at.is_some() {
                    "revoked"
                } else {
                    "active"
                };
                println!(
                    "id:{:<5} {:<width$}  user:{:<20}  last:{:<25}  {}",
                    k.id,
                    desc,
                    user,
                    last,
                    status,
                    width = desc_width
                );
            }
        }
        ListFormat::Json => println!("{}", serde_json::to_string_pretty(&keys)?),
        ListFormat::Yaml => println!("{}", serde_yaml::to_string(&keys)?),
    }
    Ok(())
}

pub fn api_key_create(
    config: &Config,
    discourse_name: &str,
    description: &str,
    username: Option<&str>,
    format: ListFormat,
    dry_run: bool,
) -> Result<()> {
    let discourse = select_discourse(config, Some(discourse_name))?;
    ensure_api_credentials(discourse)?;
    let client = DiscourseClient::new(discourse)?;

    if dry_run {
        println!(
            "[dry-run] {}: would create api key \"{}\" for user {}",
            discourse.name,
            description,
            username.unwrap_or("(all-users)")
        );
        return Ok(());
    }

    let created = client.create_api_key(description, username)?;

    match format {
        ListFormat::Text => {
            println!("New API key (shown only this once — copy it now):");
            println!();
            println!("  {}", created.key);
            println!();
            println!("id:          {}", created.id);
            if let Some(d) = &created.description {
                println!("description: {}", d);
            }
            println!("username:    {}", created.username.as_deref().unwrap_or("(all-users)"));
            if let Some(c) = &created.created_at {
                println!("created_at:  {}", c);
            }
        }
        ListFormat::Json => println!("{}", serde_json::to_string_pretty(&created)?),
        ListFormat::Yaml => println!("{}", serde_yaml::to_string(&created)?),
    }
    Ok(())
}

pub fn api_key_revoke(
    config: &Config,
    discourse_name: &str,
    key_id: u64,
    dry_run: bool,
) -> Result<()> {
    let discourse = select_discourse(config, Some(discourse_name))?;
    ensure_api_credentials(discourse)?;
    let client = DiscourseClient::new(discourse)?;

    if dry_run {
        println!("[dry-run] {}: would revoke api key id:{}", discourse.name, key_id);
        return Ok(());
    }

    client.revoke_api_key(key_id)?;
    println!("Revoked api key id:{}", key_id);
    Ok(())
}