composure 0.1.0

Discord bots over HTTP Interactions, no gateway: slash commands, components, modals and JSX-like views, on Cloudflare Workers (WASM) or any server
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

/// A State carrying Bot Data: the bot's own typed configuration and resources, built once and
/// shared by every Interaction (ADR 0014). Every Adapter's State implements it
/// (`composure_adapter_tokio::Host<T>`, `composure_adapter_cloudflare::Worker<T>`, with
/// `Data = T`), so a Command written against it runs on any of them:
///
/// ```
/// # #[cfg(feature = "macros")] mod example {
/// use composure::{command, command::{Ctx, HasData}};
///
/// pub struct Config {
///     pub greeting: String,
/// }
///
/// /// Greet with the configured greeting
/// #[command]
/// fn greet(ctx: Ctx<impl HasData<Data = Config>>) -> String {
///     format!("{} from Composure!", ctx.state().data().greeting)
/// }
/// # }
/// # fn main() {}
/// ```
///
/// When a platform's Bot Data holds more than a Command needs, bound on a part of it instead,
/// `Ctx<impl HasData<Data: AsRef<Config>>>`, and implement `AsRef<Config>` for each Bot Data
/// type.
pub trait HasData {
    /// The Bot Data
    type Data: ?Sized;

    /// The Bot Data
    fn data(&self) -> &Self::Data;
}