Struct FnHandler 

pub struct FnHandler { /* private fields */ }

A lightweight handler that pairs a predicate with an async callback.

FnHandler bridges the gap between raw application::Handler structs and the typed handler trait system. It implements Handler so it can be registered via [Application::add_handler].

Examples

use rust_tg_bot::ext::prelude::*;
use rust_tg_bot::ext::handlers::base::FnHandler;

async fn button_handler(update: Update, context: Context) -> HandlerResult {
    // handle callback query ...
    Ok(())
}

// Register with a predicate:
app.add_handler(
    FnHandler::new(|u| u.callback_query().is_some(), button_handler),
    0,
).await;

// Or use a convenience constructor:
app.add_handler(FnHandler::on_callback_query(button_handler), 0).await;

Implementations

impl FnHandler

pub fn new<C, Cb, Fut>(check: C, callback: Cb) -> FnHandler

where C: Fn(&Update) -> bool + Send + Sync + 'static, Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Create a new FnHandler with a custom predicate and an async callback.

The callback receives (Update, CallbackContext) and returns Result<(), HandlerError>.

pub fn on_callback_query<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a callback_query.

pub fn on_inline_query<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have an inline_query.

pub fn on_poll<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a poll.

pub fn on_poll_answer<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a poll_answer.

pub fn on_shipping_query<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a shipping_query.

pub fn on_pre_checkout_query<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a pre_checkout_query.

pub fn on_chat_member<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a chat_member.

pub fn on_my_chat_member<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a my_chat_member.

pub fn on_message<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match updates that have a message.

pub fn on_any<Cb, Fut>(callback: Cb) -> FnHandler

where Cb: Fn(Arc<Update>, CallbackContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), HandlerError>> + Send + 'static,

Match every update (catch-all).

Trait Implementations

impl Handler for FnHandler

fn check_update(&self, update: &Update) -> Option<MatchResult>

Determine whether this handler is interested in update.

fn handle_update( &self, _update: Arc<Update>, _match_result: MatchResult, ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send>>

Process the update. Called only when check_update returned Some.

fn handle_update_with_context( &self, update: Arc<Update>, _match_result: MatchResult, context: CallbackContext, ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send>>

Process the update with an Application-provided CallbackContext.

fn block(&self) -> bool

Whether the application should block on this handler’s future before dispatching to the next handler group.

fn collect_additional_context( &self, _context: &mut CallbackContext, _match_result: &MatchResult, )

Populate additional context fields (e.g. context.args, context.matches) from the match result before the handler callback is invoked.