Hubbub

Rust library for creating discord self-bots (very early in development)

Current features

• Allows passing a model
• Connects to gateway with token
• Supports reconnecting to gateway (semi tested, should work)
• Supports making calls to discords http api (any version)
• Supports sending and receiving gateway events
• Most of discord's many, MANY, data structures have been translated into serde-compatible structs
• Major structs have convenience functions for doing common tasks (eg: creating a message)

Using the library

1. Add the library to your project using cargo add hubbub
2. Import hubbub::prelude::*:
3. Create your model

   struct App {
   // ...
   }

4. Create the client

   #[tokio::main]
   async fn main() -> anyhow::Result<()> {
   let mut client = Client::new(
       App { /* ... */ },
       /* Event handler */
   ).await?;
   
   client.token(/* Token */).await?;
   client.login().await?;
   client.run().await?;
   }

5. Create the event handler

   async fn main() {
   // ...
   
   /* Event handler */
   Box::from(
       |ctx: Ctx, ws: Ws, model: Model<App>, msg: DiscordMessage| async move {
           /* do work here */
       }
   )
   
   // ...
   }

6. Success, hopefully!

Any questions?

• Look at the examples
• Look at the Context and DiscordMessage structs
• Look at prelude