Struct Context 

pub struct Context { /* private fields */ }

Context for handling bot events

Provides access to event data and platform client. Platform-specific details are abstracted away - handlers work with a unified API.

Implementations

impl Context

pub fn new<T: ContextData>(data: T) -> Self

Create a new context (called by platform implementations)

pub fn channel_id(&self) -> &str

Get the channel/chat ID

pub fn user_id(&self) -> &str

Get the user ID who triggered the event

pub fn user_name(&self) -> &str

Get the user’s display name

pub fn command_name(&self) -> Option<&str>

Get the command name if this is a command event

pub fn command_args(&self) -> Option<&str>

Get command arguments as a string (for Telegram-style commands)

pub fn option(&self, name: &str) -> Option<OptionValue>

Get a command option value by name

pub fn button_id(&self) -> Option<&str>

Get the button/callback custom_id if this is a button event

pub fn message_content(&self) -> Option<&str>

Get the message content if available

pub fn platform<T: 'static>(&self) -> Option<&T>

Access platform-specific raw data (for advanced use cases)

Returns Some(&T) if the underlying platform data is of type T.

pub fn data(&self) -> &dyn ContextData

Get the inner context data for platform implementations

pub fn typing(&self) -> Option<ChatActionGuard>

Start a typing indicator that auto-renews until the guard is dropped

Returns None if the platform doesn’t support typing indicators or if the context doesn’t have the necessary client.

Example

async fn slow_command(ctx: Context) -> String {
    let _typing = ctx.typing();
    // Do slow work...
    expensive_computation().await;
    "Done!"
}

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl FromContext for Context

Extract the full context (for advanced use cases)

async fn from_context(ctx: &Context) -> Self

Extract data from the context