Struct automate::Discord

pub struct Discord { /* fields omitted */ }

The struct used to register listeners, setup configuration and establish connection with Discord.

Example

use automate::Discord;

Discord::new(&std::env::var("DISCORD_API_TOKEN").expect("API token not found"))
    .connect_blocking()
    .expect("Bot crashed")

Methods

impl Discord

pub fn new(token: &str) -> Discord

Creates an instance of this struct with the provided token. The token can be generated on Discord's developers portal

pub fn with_listener(self, listener: Box<dyn Listener + Send>) -> Self

Registers an event listener

pub async fn connect(self) -> Result<!, Error>

Asynchronous function setup the connection with Discord. Will block forever unless the bot crashes.

pub fn connect_blocking(self) -> Result<!, Error>

Non asynchronous equivalent for the connect function to setup the connection with discord. Creates a tokio runtime.

Will block forever unless the bot crashes.

pub fn connect_detached(self) -> JoinHandle<Result<!, Error>>

Non asynchronous equivalent for the connect function to setup the connection with discord. This function establishes the connection and runs the event loop in a separate thread whose JoinHandle is returned.