botrs 0.13.0

A Rust QQ Bot framework based on QQ Guild Bot 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

use super::{BotApi, resource};
use crate::error::Result;
use crate::models::api::PinsMessage;
use tracing::debug;

impl BotApi {
    /// Pins one message in a channel.
    pub async fn put_pin(&self, channel_id: &str, message_id: &str) -> Result<PinsMessage> {
        debug!("Pinning message {} in channel {}", message_id, channel_id);
        let path = resource::channel_pin(channel_id, message_id);
        let response = self
            .http
            .put(self.token(), &path, None::<&()>, None::<&()>)
            .await?;
        Self::decode_json(response)
    }

    /// Unpins one message from a channel.
    pub async fn delete_pin(&self, channel_id: &str, message_id: &str) -> Result<()> {
        debug!("Unpinning message {} in channel {}", message_id, channel_id);
        let path = resource::channel_pin(channel_id, message_id);
        self.http.delete(self.token(), &path, None::<&()>).await?;
        Ok(())
    }

    /// Clears all pinned messages in a channel.
    pub async fn clean_pins(&self, channel_id: &str) -> Result<()> {
        debug!("Clearing pinned messages in channel {}", channel_id);
        let path = resource::channel_pins_all(channel_id);
        self.http.delete(self.token(), &path, None::<&()>).await?;
        Ok(())
    }

    /// Lists pinned messages in a channel.
    pub async fn get_pins(&self, channel_id: &str) -> Result<PinsMessage> {
        debug!("Getting pinned messages in channel {}", channel_id);
        let path = resource::channel_pins(channel_id);
        let response = self.http.get(self.token(), &path, None::<&()>).await?;
        Self::decode_json(response)
    }
}