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
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
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176

use super::Context;
use super::prelude::*;

/// Event handler trait for processing gateway events.
#[async_trait::async_trait]
pub trait EventHandler: Send + Sync {
    /// Called when the bot is ready and connected.
    async fn ready(&self, _ctx: Context, _ready: Ready) {}

    /// Called when the bot session has resumed.
    async fn resumed(&self, _ctx: Context) {}

    /// Called when a message is created (@ mentions).
    async fn message_create(&self, _ctx: Context, _message: Message) {}

    /// Called when a direct message is created.
    async fn direct_message_create(&self, _ctx: Context, _message: Message) {}

    /// Called when a direct message is deleted.
    async fn direct_message_delete(&self, _ctx: Context, _message: MessageDelete) {}

    /// Called when a group message is created.
    async fn group_message_create(&self, _ctx: Context, _message: GroupMessage) {}

    /// Called when a C2C message is created.
    async fn c2c_message_create(&self, _ctx: Context, _message: C2CMessage) {}

    /// Called when a message is deleted.
    async fn message_delete(&self, _ctx: Context, _message: MessageDelete) {}

    /// Called when a public guild message is deleted.
    async fn public_message_delete(&self, _ctx: Context, _message: MessageDelete) {}

    /// Called when a reaction is added to a message.
    async fn message_reaction_add(&self, _ctx: Context, _reaction: Reaction) {}

    /// Called when a reaction is removed from a message.
    async fn message_reaction_remove(&self, _ctx: Context, _reaction: Reaction) {}

    /// Called when an interaction event is created.
    async fn interaction_create(&self, _ctx: Context, _interaction: Interaction) {}

    /// Called when audio starts.
    async fn audio_start(&self, _ctx: Context, _audio: Audio) {}

    /// Called when audio finishes.
    async fn audio_finish(&self, _ctx: Context, _audio: Audio) {}

    /// Called when microphone is turned on.
    async fn on_mic(&self, _ctx: Context, _audio: Audio) {}

    /// Called when microphone is turned off.
    async fn off_mic(&self, _ctx: Context, _audio: Audio) {}

    /// Called when a guild is created (bot joins).
    async fn guild_create(&self, _ctx: Context, _guild: Guild) {}

    /// Called when a guild is updated.
    async fn guild_update(&self, _ctx: Context, _guild: Guild) {}

    /// Called when a guild is deleted (bot leaves).
    async fn guild_delete(&self, _ctx: Context, _guild: Guild) {}

    /// Called when a channel is created.
    async fn channel_create(&self, _ctx: Context, _channel: Channel) {}

    /// Called when a channel is updated.
    async fn channel_update(&self, _ctx: Context, _channel: Channel) {}

    /// Called when a channel is deleted.
    async fn channel_delete(&self, _ctx: Context, _channel: Channel) {}

    /// Called when a guild member is added.
    async fn guild_member_add(&self, _ctx: Context, _member: Member) {}

    /// Called when a guild member is updated.
    async fn guild_member_update(&self, _ctx: Context, _member: Member) {}

    /// Called when a guild member is removed.
    async fn guild_member_remove(&self, _ctx: Context, _member: Member) {}

    /// Called when a message audit passes.
    async fn message_audit_pass(&self, _ctx: Context, _audit: MessageAudit) {}

    /// Called when a message audit is rejected.
    async fn message_audit_reject(&self, _ctx: Context, _audit: MessageAudit) {}

    /// Called when a friend is added.
    async fn friend_add(&self, _ctx: Context, _event: C2CManageEvent) {}

    /// Called when a friend is deleted.
    async fn friend_del(&self, _ctx: Context, _event: C2CManageEvent) {}

    /// Called when C2C message is rejected.
    async fn c2c_msg_reject(&self, _ctx: Context, _event: C2CManageEvent) {}

    /// Called when C2C message is received.
    async fn c2c_msg_receive(&self, _ctx: Context, _event: C2CManageEvent) {}

    /// Called when subscribe message authorization status changes.
    async fn subscribe_message_status(&self, _ctx: Context, _event: SubscribeMessageStatusData) {}

    /// Called when a user enters AIO.
    async fn enter_aio(&self, _ctx: Context, _event: EnterAioEvent) {}

    /// Called when robot is added to group.
    async fn group_add_robot(&self, _ctx: Context, _event: GroupManageEvent) {}

    /// Called when robot is deleted from group.
    async fn group_del_robot(&self, _ctx: Context, _event: GroupManageEvent) {}

    /// Called when group message is rejected.
    async fn group_msg_reject(&self, _ctx: Context, _event: GroupManageEvent) {}

    /// Called when group message is received.
    async fn group_msg_receive(&self, _ctx: Context, _event: GroupManageEvent) {}

    /// Called when a user enters an audio or live channel.
    async fn audio_or_live_channel_member_enter(&self, _ctx: Context, _audio: PublicAudio) {}

    /// Called when a user exits an audio or live channel.
    async fn audio_or_live_channel_member_exit(&self, _ctx: Context, _audio: PublicAudio) {}

    /// Called when a forum thread is created.
    async fn forum_thread_create(&self, _ctx: Context, _thread: Thread) {}

    /// Called when a forum thread is updated.
    async fn forum_thread_update(&self, _ctx: Context, _thread: Thread) {}

    /// Called when a forum thread is deleted.
    async fn forum_thread_delete(&self, _ctx: Context, _thread: Thread) {}

    /// Called when a forum post is created.
    async fn forum_post_create(&self, _ctx: Context, _post: Post) {}

    /// Called when a forum post is deleted.
    async fn forum_post_delete(&self, _ctx: Context, _post: Post) {}

    /// Called when a forum reply is created.
    async fn forum_reply_create(&self, _ctx: Context, _reply: Reply) {}

    /// Called when a forum reply is deleted.
    async fn forum_reply_delete(&self, _ctx: Context, _reply: Reply) {}

    /// Called when a forum publish audit result arrives.
    async fn forum_publish_audit_result(&self, _ctx: Context, _result: ForumAuditResult) {}

    /// Called when an open forum thread is created.
    async fn open_forum_thread_create(&self, _ctx: Context, _thread: OpenThread) {}

    /// Called when an open forum thread is updated.
    async fn open_forum_thread_update(&self, _ctx: Context, _thread: OpenThread) {}

    /// Called when an open forum thread is deleted.
    async fn open_forum_thread_delete(&self, _ctx: Context, _thread: OpenThread) {}

    /// Called when an open forum post is created.
    async fn open_forum_post_create(&self, _ctx: Context, _thread: OpenThread) {}

    /// Called when an open forum post is deleted.
    async fn open_forum_post_delete(&self, _ctx: Context, _thread: OpenThread) {}

    /// Called when an open forum reply is created.
    async fn open_forum_reply_create(&self, _ctx: Context, _thread: OpenThread) {}

    /// Called when an open forum reply is deleted.
    async fn open_forum_reply_delete(&self, _ctx: Context, _thread: OpenThread) {}

    /// Called for any unhandled events.
    async fn unknown_event(&self, _ctx: Context, _event: GatewayEvent) {}

    /// Called when an error occurs during event processing.
    async fn error(&self, _error: BotError) {
        error!("Event handler error: {}", _error);
    }
}