bevy-discord 0.9.0

A bevy plugin for sending and receiving discord messages.
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

//! Configuration types for Discord bot and Rich Presence integration.
//!
//! This module provides configuration structures for both Discord bot functionality
//! and Rich Presence integration. The configurations are split into two main components:
//!
//! - [`DiscordBotConfig`]: Configuration for the Discord bot (available with `bot` feature)
//! - [`DiscordRichPresenceConfig`]: Configuration for Rich Presence integration (available with `rich_presence` feature)

use crate::common::initialize_field_with_doc;
use bevy_ecs::prelude::*;

#[cfg(feature = "bot")]
use {crate::common::override_field_with_doc, serenity::all::*};

/// Configuration settings for the Discord bot.
///
/// This struct allows you to configure various aspects of the bot including:
/// - Bot token
/// - Gateway intents
/// - Online status
/// - Activity status
#[cfg(feature = "bot")]
#[cfg_attr(docsrs, doc(cfg(feature = "bot")))]
#[derive(Default, Resource, Clone, Debug)]
pub struct DiscordBotConfig {
    pub(crate) token: String,
    pub(crate) gateway_intents: GatewayIntents,
    pub(crate) status: Option<OnlineStatus>,
    pub(crate) activity: Option<ActivityData>,
    pub(crate) shards: u32,
}

#[cfg(feature = "bot")]
impl DiscordBotConfig {
    initialize_field_with_doc!(token, String, "Sets the bot token.");
    initialize_field_with_doc!(
        gateway_intents,
        GatewayIntents,
        "Sets the bot [`GatewayIntents`]."
    );
    override_field_with_doc!(status, OnlineStatus, "Sets the initial status.");
    override_field_with_doc!(activity, ActivityData, "Sets the initial activity.");
    initialize_field_with_doc!(shards, u32, "The total number of shards to use.");
}

/// Configuration settings for Discord Rich Presence integration.
///
/// This struct allows configuring Rich Presence features including:
/// - Discord Application ID
/// - Rich Presence subscriptions
#[cfg(feature = "rich_presence")]
#[cfg_attr(docsrs, doc(cfg(feature = "rich_presence")))]
#[derive(Resource, Clone)]
pub struct DiscordRichPresenceConfig {
    pub(crate) app: discord_sdk::AppId,
    pub(crate) subscriptions: discord_sdk::Subscriptions,
}

#[cfg(feature = "rich_presence")]
impl std::fmt::Debug for DiscordRichPresenceConfig {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("DiscordRichPresenceConfig")
            .field("app", &self.app)
            .field("subscriptions", &self.subscriptions.bits())
            .finish()
    }
}

#[cfg(feature = "rich_presence")]
impl Default for DiscordRichPresenceConfig {
    fn default() -> Self {
        Self {
            app: 0,
            subscriptions: discord_sdk::Subscriptions::all(),
        }
    }
}

#[cfg(feature = "rich_presence")]
impl DiscordRichPresenceConfig {
    initialize_field_with_doc!(app, discord_sdk::AppId, "Set the Discord Application ID.");
    initialize_field_with_doc!(
        subscriptions,
        discord_sdk::Subscriptions,
        "Set the subscription for Rich Presence"
    );
}