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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

mod common;
use common::*;
use tempfile::TempDir;

fn make_config(dir: &TempDir, test: &TestDiscourse) -> std::path::PathBuf {
    write_temp_config(
        dir,
        &format!(
            "[[discourse]]\nname = \"{}\"\nbaseurl = \"{}\"\napikey = \"{}\"\napi_username = \"{}\"\n",
            test.name, test.baseurl, test.apikey, test.api_username
        ),
    )
}

#[test]
fn setting_list() {
    let Some(test) = test_discourse() else {
        return;
    };
    vprintln("e2e_setting_list: listing site settings");
    let dir = TempDir::new().expect("tempdir");
    let config_path = make_config(&dir, &test);
    let output = run_dsc(&["setting", "list", &test.name], &config_path);
    assert!(
        output.status.success(),
        "setting list failed: {}",
        String::from_utf8_lossy(&output.stderr)
    );
    let stdout = String::from_utf8_lossy(&output.stdout);
    // The output should contain at least one "key = value" line.
    assert!(
        stdout.contains(" = "),
        "expected key = value lines in output, got: {}",
        stdout
    );
}

#[test]
fn setting_list_json() {
    let Some(test) = test_discourse() else {
        return;
    };
    vprintln("e2e_setting_list_json: listing site settings as JSON");
    let dir = TempDir::new().expect("tempdir");
    let config_path = make_config(&dir, &test);
    let output = run_dsc(
        &["setting", "list", &test.name, "--format", "json"],
        &config_path,
    );
    assert!(
        output.status.success(),
        "setting list --format json failed: {}",
        String::from_utf8_lossy(&output.stderr)
    );
    let stdout = String::from_utf8_lossy(&output.stdout);
    let parsed: serde_json::Value = serde_json::from_str(&stdout)
        .expect("setting list --format json did not produce valid JSON");
    assert!(parsed.is_array(), "expected JSON array, got: {}", stdout);
}

#[test]
fn setting_get() {
    let Some(test) = test_discourse() else {
        return;
    };
    vprintln("e2e_setting_get: fetching a known site setting");
    let dir = TempDir::new().expect("tempdir");
    let config_path = make_config(&dir, &test);
    // title is a standard Discourse site setting that always exists.
    let output = run_dsc(&["setting", "get", &test.name, "title"], &config_path);
    assert!(
        output.status.success(),
        "setting get title failed: {}",
        String::from_utf8_lossy(&output.stderr)
    );
    let stdout = String::from_utf8_lossy(&output.stdout);
    assert!(
        !stdout.trim().is_empty(),
        "expected non-empty value for 'title' setting"
    );
}

#[test]
fn setting_get_missing() {
    let Some(test) = test_discourse() else {
        return;
    };
    vprintln("e2e_setting_get_missing: fetching a non-existent setting should fail");
    let dir = TempDir::new().expect("tempdir");
    let config_path = make_config(&dir, &test);
    let output = run_dsc(
        &[
            "setting",
            "get",
            &test.name,
            "this_setting_does_not_exist_xyzzy",
        ],
        &config_path,
    );
    assert!(
        !output.status.success(),
        "expected failure for missing setting, but it succeeded"
    );
}

#[test]
fn setting_set() {
    let Some(test) = test_discourse() else {
        return;
    };
    vprintln("e2e_setting_set: updating a site setting");
    let dir = TempDir::new().expect("tempdir");
    let config_path = make_config(&dir, &test);
    // Fetch the current value of 'contact_email', flip it, then restore.
    // Use a safe benign setting: 'default_locale' is available but risky.
    // Instead, just verify we can set a known writable setting without error.
    // We use 'short_site_description' which is typically an empty string.
    let marker = "dsc-e2e-test-marker";
    let set_output = run_dsc(
        &[
            "setting",
            "set",
            &test.name,
            "short_site_description",
            marker,
        ],
        &config_path,
    );
    assert!(
        set_output.status.success(),
        "setting set failed: {}",
        String::from_utf8_lossy(&set_output.stderr)
    );
    let stdout = String::from_utf8_lossy(&set_output.stdout);
    assert!(
        stdout.contains("updated"),
        "expected 'updated' in output, got: {}",
        stdout
    );

    // Verify the value was actually set.
    let get_output = run_dsc(
        &["setting", "get", &test.name, "short_site_description"],
        &config_path,
    );
    assert!(get_output.status.success(), "setting get after set failed");
    let got = String::from_utf8_lossy(&get_output.stdout);
    assert!(
        got.trim() == marker,
        "expected '{}', got '{}'",
        marker,
        got.trim()
    );

    // Restore to empty.
    run_dsc(
        &["setting", "set", &test.name, "short_site_description", ""],
        &config_path,
    );
}