hey-sdk 0.31.0

Rust client for the HEY API, generated from a Smithy model of the 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

//! Keeping snippets — the reusable bits of text the composer offers — on top of the
//! generated snippet route.
//!
//! Snippets have no JSON surface for writes: every one of them redirects, so they are
//! browser form posts.

use crate::error::Error;
use crate::http::Method;
use crate::services::write_info;

pub use crate::generated::services::snippets::*;

impl Snippets<'_> {
    /// Saves a snippet.
    pub async fn create(&self, name: &str, content: &str) -> Result<(), Error> {
        let mut operation = self.client().form(Method::POST, "/snippets")?;
        operation.info(write_info("Snippets", "CreateSnippet", "snippet", None));
        operation.form(&snippet_fields(name, content));
        self.client().send_unit(operation).await
    }

    /// Edits a snippet. An empty field is left out of the form, and so left as it was.
    pub async fn update(&self, snippet_id: i64, name: &str, content: &str) -> Result<(), Error> {
        let mut operation = self
            .client()
            .form(Method::PATCH, &format!("/snippets/{snippet_id}"))?;
        operation.info(write_info(
            "Snippets",
            "UpdateSnippet",
            "snippet",
            Some(snippet_id),
        ));
        operation.form(&snippet_fields(name, content));
        self.client().send_unit(operation).await
    }

    /// Throws a snippet away.
    pub async fn delete(&self, snippet_id: i64) -> Result<(), Error> {
        let mut operation = self
            .client()
            .form(Method::DELETE, &format!("/snippets/{snippet_id}"))?;
        operation.info(write_info(
            "Snippets",
            "DeleteSnippet",
            "snippet",
            Some(snippet_id),
        ));
        self.client().send_unit(operation).await
    }
}

fn snippet_fields<'a>(name: &'a str, content: &'a str) -> Vec<(&'a str, &'a str)> {
    let mut fields = Vec::new();
    if !name.is_empty() {
        fields.push(("snippet[name]", name));
    }
    if !content.is_empty() {
        fields.push(("snippet[content]", content));
    }
    fields
}