Trait teloxide_core::requests::RequesterExt

pub trait RequesterExt: Requester {
    fn cache_me(self) -> CacheMe<Self>
    where
        Self: Sized,
    { ... }
    fn auto_send(self) -> AutoSend<Self>
    where
        Self: Sized,
    { ... }
    fn erase<'a>(self) -> ErasedRequester<'a, Self::Err>
    where
        Self: 'a,
        Self: Sized,
    { ... }
    fn trace(self, settings: Settings) -> Trace<Self>
    where
        Self: Sized,
    { ... }
    fn throttle(self, limits: Limits) -> Throttle<Self>
    where
        Self: Sized + Clone + Send + Sync + 'static,
        Self::Err: AsResponseParameters,
        Self::GetChat: Send,
    { ... }
    fn parse_mode(self, parse_mode: ParseMode) -> DefaultParseMode<Self>
    where
        Self: Sized,
    { ... }
}

Extensions methods for Requester.

Provided Methods

fn cache_me(self) -> CacheMe<Self>where
    Self: Sized,

Available on crate feature cache_me only.

Add get_me caching ability, see CacheMe for more.

fn auto_send(self) -> AutoSend<Self>where
    Self: Sized,

👎Deprecated since 0.8.0: AutoSend is no longer required to .await requests and is now noop

Available on crate feature auto_send only.

Send requests automatically, see AutoSend for more.

fn erase<'a>(self) -> ErasedRequester<'a, Self::Err>where
    Self: 'a,
    Self: Sized,

Available on crate feature erased only.

Erase requester type.

Examples found in repository

examples/erased.rs (line 35)

≺ ≻↕

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    pretty_env_logger::init();

    let chat_id = ChatId(
        std::env::var("CHAT_ID")
            .expect("Expected CHAT_ID env var")
            .parse::<i64>()?,
    );

    let trace_settings = match std::env::var("TRACE").as_deref() {
        Ok("EVERYTHING_VERBOSE") => trace::Settings::TRACE_EVERYTHING_VERBOSE,
        Ok("EVERYTHING") => trace::Settings::TRACE_EVERYTHING,
        Ok("REQUESTS_VERBOSE") => trace::Settings::TRACE_REQUESTS_VERBOSE,
        Ok("REQUESTS") => trace::Settings::TRACE_REQUESTS,
        Ok("RESPONSES_VERBOSE") => trace::Settings::TRACE_RESPONSES_VERBOSE,
        Ok("RESPONSES") => trace::Settings::TRACE_RESPONSES,
        Ok("EMPTY") | Ok("") | Err(VarError::NotPresent) => trace::Settings::empty(),
        Ok(_) | Err(VarError::NotUnicode(_)) => {
            panic!(
                "Expected `TRACE` environment variable to be equal to any of the following: \
                 `EVERYTHING_VERBOSE`, `EVERYTHING`, `REQUESTS_VERBOSE`, `REQUESTS`, \
                 `RESPONSES_VERBOSE`, `RESPONSES`, `EMPTY`, `` (empty string)"
            )
        }
    };

    log::info!("Trace settings: {:?}", trace_settings);

    let bot = if trace_settings.is_empty() {
        Bot::from_env().erase()
    } else {
        Bot::from_env().trace(trace_settings).erase()
    };

    bot.send_chat_action(chat_id, ChatAction::Typing).await?;
    tokio::time::sleep(Duration::from_secs(1)).await;
    bot.send_message(chat_id, "Hey hey hey").await?;

    Ok(())
}

fn trace(self, settings: Settings) -> Trace<Self>where
    Self: Sized,

Available on crate feature trace_adaptor only.

Trace requests, see Trace for more.

Examples found in repository

examples/erased.rs (line 37)

↕

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    pretty_env_logger::init();

    let chat_id = ChatId(
        std::env::var("CHAT_ID")
            .expect("Expected CHAT_ID env var")
            .parse::<i64>()?,
    );

    let trace_settings = match std::env::var("TRACE").as_deref() {
        Ok("EVERYTHING_VERBOSE") => trace::Settings::TRACE_EVERYTHING_VERBOSE,
        Ok("EVERYTHING") => trace::Settings::TRACE_EVERYTHING,
        Ok("REQUESTS_VERBOSE") => trace::Settings::TRACE_REQUESTS_VERBOSE,
        Ok("REQUESTS") => trace::Settings::TRACE_REQUESTS,
        Ok("RESPONSES_VERBOSE") => trace::Settings::TRACE_RESPONSES_VERBOSE,
        Ok("RESPONSES") => trace::Settings::TRACE_RESPONSES,
        Ok("EMPTY") | Ok("") | Err(VarError::NotPresent) => trace::Settings::empty(),
        Ok(_) | Err(VarError::NotUnicode(_)) => {
            panic!(
                "Expected `TRACE` environment variable to be equal to any of the following: \
                 `EVERYTHING_VERBOSE`, `EVERYTHING`, `REQUESTS_VERBOSE`, `REQUESTS`, \
                 `RESPONSES_VERBOSE`, `RESPONSES`, `EMPTY`, `` (empty string)"
            )
        }
    };

    log::info!("Trace settings: {:?}", trace_settings);

    let bot = if trace_settings.is_empty() {
        Bot::from_env().erase()
    } else {
        Bot::from_env().trace(trace_settings).erase()
    };

    bot.send_chat_action(chat_id, ChatAction::Typing).await?;
    tokio::time::sleep(Duration::from_secs(1)).await;
    bot.send_message(chat_id, "Hey hey hey").await?;

    Ok(())
}

fn throttle(self, limits: Limits) -> Throttle<Self>where
    Self: Sized + Clone + Send + Sync + 'static,
    Self::Err: AsResponseParameters,
    Self::GetChat: Send,

Available on crate feature throttle only.

Add throttling ability, see Throttle for more.

Note: this spawns the worker, just as Throttle::new_spawn.

fn parse_mode(self, parse_mode: ParseMode) -> DefaultParseMode<Self>where
    Self: Sized,

Specifies default ParseMode, which will be used during all calls to:

• send_message
• send_photo
• send_video
• send_audio
• send_document
• send_animation
• send_voice
• send_poll
• edit_message_text (and edit_message_text_inline)
• edit_message_caption (and edit_message_caption_inline)

Examples found in repository

examples/self_info.rs (line 16)

↕

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    pretty_env_logger::init();

    let chat_id = ChatId(
        std::env::var("CHAT_ID")
            .expect("Expected CHAT_ID env var")
            .parse::<i64>()?,
    );

    let bot = Bot::from_env().parse_mode(ParseMode::MarkdownV2);

    let Me { user: me, .. } = bot.get_me().await?;

    bot.send_dice(chat_id).emoji(DiceEmoji::Dice).await?;
    bot.send_message(chat_id, format!("Hi, my name is **{}** 👋", me.first_name))
        .await?;

    Ok(())
}

Implementors

impl<T> RequesterExt for Twhere
    T: Requester,