harmony_rust_sdk 0.8.0

Rust library to work with the Harmony chat protocol.
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

pub use crate::api::chat::{
    get_channel_messages_request::Direction, CreateChannelRequest, DeleteChannelRequest,
    GetChannelMessagesRequest, GetGuildChannelsRequest, UpdateChannelInformationRequest,
    UpdateChannelOrderRequest,
};

use super::{
    harmonytypes::{ItemPosition, Metadata},
    *,
};

/// Convenience type to create a valid [`GetChannelMessagesRequest`].
///
/// If `before_message_id` is not specified, it will default to `0`, which
/// means the server should return the latest messages.
///
/// Note that the number of messages returned may be limited by servers.
#[impl_call_action(chat)]
#[derive(Debug, new, Clone, self_builder)]
pub struct GetChannelMessages {
    guild_id: u64,
    channel_id: u64,
    #[new(default)]
    message_id: Option<u64>,
    #[new(default)]
    #[builder(setter(strip_option))]
    direction: Option<Direction>,
    #[new(default)]
    #[builder(setter(strip_option))]
    count: Option<u32>,
}

impl From<GetChannelMessages> for GetChannelMessagesRequest {
    fn from(o: GetChannelMessages) -> Self {
        Self {
            guild_id: o.guild_id,
            channel_id: o.channel_id,
            message_id: o.message_id,
            direction: o.direction.map(Into::into),
            count: o.count,
        }
    }
}

impl_into_req_from!(GetChannelMessages);

/// Convenience type to create a valid [`CreateChannelRequest`].
#[impl_call_action(chat)]
#[into_request("CreateChannelRequest")]
#[derive(Debug, new, Clone, self_builder)]
pub struct CreateChannel {
    guild_id: u64,
    channel_name: String,
    #[new(default)]
    #[builder(setter(strip_option))]
    position: Option<ItemPosition>,
    #[new(default)]
    #[builder(setter(strip_option))]
    metadata: Option<Metadata>,
    #[new(default)]
    kind: ChannelKind,
}

/// Convenience type to create a valid [`DeleteChannelRequest`].
#[impl_call_action(chat)]
#[into_request("DeleteChannelRequest")]
#[derive(Debug, Clone, new)]
pub struct DeleteChannel {
    guild_id: u64,
    channel_id: u64,
}

/// Convenience type to create a valid [`UpdateChannelInformationRequest`].
#[impl_call_action(chat)]
#[derive(Debug, Clone, new, self_builder)]
pub struct UpdateChannelInformation {
    guild_id: u64,
    channel_id: u64,
    #[new(default)]
    #[builder(setter(strip_option))]
    new_name: Option<String>,
    #[builder(setter(strip_option))]
    #[new(default)]
    new_metadata: Option<Option<Metadata>>,
}

impl From<UpdateChannelInformation> for UpdateChannelInformationRequest {
    fn from(u: UpdateChannelInformation) -> Self {
        Self {
            guild_id: u.guild_id,
            channel_id: u.channel_id,
            new_name: u.new_name,
            new_metadata: u.new_metadata.map(Option::unwrap_or_default),
        }
    }
}

impl_into_req_from!(UpdateChannelInformation);

/// Convenience type to create a valid [`UpdateChannelOrderRequest`].
#[impl_call_action(chat)]
#[into_request("UpdateChannelOrderRequest")]
#[derive(Debug, Clone, new)]
pub struct UpdateChannelOrder {
    guild_id: u64,
    channel_id: u64,
    new_position: ItemPosition,
}