Struct BotBuilder 

pub struct BotBuilder { /* private fields */ }

Builder for constructing bots with handlers

Handlers are indexed as they are registered, so dispatch is a hash lookup rather than a scan. When two handlers claim the same command or button id, the first one registered wins.

Implementations

impl BotBuilder

pub fn new() -> Self

Create a new bot builder

pub fn command<H, Args>(self, name: impl Into<String>, handler: H) -> Self

where H: IntoHandler<Args>,

Register a command handler

Handlers use the extractor/responder pattern:

// Simple handler
async fn ping() -> &'static str {
    "Pong!"
}

// With extractors
async fn greet(user: User) -> String {
    format!("Hello, {}!", user.name)
}

bot.command("ping", ping)
   .command("greet", greet)

pub fn command_with_description<H, Args>( self, name: impl Into<String>, description: impl Into<String>, handler: H, ) -> Self

where H: IntoHandler<Args>,

Register a command handler with a description

The description is used for slash command menus (e.g., Telegram’s /command list).

pub fn button<H, Args>(self, pattern: impl Into<String>, handler: H) -> Self

where H: IntoHandler<Args>,

Register a button handler with pattern matching

Pattern can end with * for prefix matching (e.g., “confirm_*”). Exact ids take priority over prefix patterns.

pub fn message<H, Args>(self, handler: H) -> Self

where H: IntoHandler<Args>,

Register a catch-all message handler

Only one message handler is used; later registrations are ignored.

pub fn fallback<H, Args>(self, handler: H) -> Self

where H: IntoHandler<Args>,

Register a handler for events nothing else claimed

Consulted after command, button, and message routing: an unregistered command or an unmatched button reaches the fallback rather than being dropped. Plain messages still prefer the message handler when one is registered.

Only one fallback is used; later registrations are ignored.

pub fn commands(&self) -> impl Iterator<Item = CommandInfo<'_>>

Get all registered commands with their descriptions, in registration order

pub fn has_commands(&self) -> bool

Whether any command handler is registered

pub fn route(&self, event: Event<'_>) -> Option<&AnyHandler>

Find the handler that should serve an event

Commands and exact button ids resolve with a single hash lookup; only wildcard button patterns fall back to a scan. An event no route claims resolves to the fallback handler, if any.

Trait Implementations

impl Default for BotBuilder

fn default() -> BotBuilder

Returns the “default value” for a type.