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

use super::client::DiscourseClient;
use super::error::http_error;
use anyhow::{Context, Result};
use serde_json::Value;

impl DiscourseClient {
    /// Trigger a backup on the Discourse instance.
    pub fn create_backup(&self) -> Result<()> {
        let payload = [("with_uploads", "true")];
        let response = self.send_retrying(|| Ok(self.post("/admin/backups.json")?.form(&payload)))?;
        let status = response.status();
        let text = response.text().context("reading backup create response")?;
        if !status.is_success() {
            return Err(http_error("create backup request", status, &text));
        }
        Ok(())
    }

    /// List backups available on the Discourse instance.
    pub fn list_backups(&self) -> Result<Value> {
        let response = self.get("/admin/backups.json")?;
        let status = response.status();
        let text = response.text().context("reading backups list response")?;
        if !status.is_success() {
            return Err(http_error("list backups request", status, &text));
        }
        let body: Value = serde_json::from_str(&text).context("parsing backups list json")?;
        Ok(body)
    }

    /// Restore a backup by filename/path.
    pub fn restore_backup(&self, backup_path: &str) -> Result<()> {
        let path = format!("/admin/backups/{}/restore", backup_path);
        let response = self.send_retrying(|| Ok(self.post(&path)?))?;
        let status = response.status();
        let text = response.text().context("reading backup restore response")?;
        if !status.is_success() {
            return Err(http_error("restore backup request", status, &text));
        }
        Ok(())
    }
}