Struct tbot::event_loop::Polling

#[must_use = "polling does nothing unless `start` is called"]
pub struct Polling<C> { /* fields omitted */ }

Configures and starts polling.

To construct Polling, use Bot::polling.

Methods

impl<C> Polling<C>

pub fn limit(self, limit: u8) -> Self

Configures the limit of updates per request.

pub fn timeout(self, timeout: u64) -> Self

Configures the timeout for long polling.

pub fn allowed_updates(self, allowed_updates: &'static [UpdateKind]) -> Self

Configures which updates you'd like to listen to.

pub fn error_handler<H, F>(self, handler: H) -> Self where
    H: Fn(Polling) -> F + Send + Sync + 'static,
    F: Future<Output = ()> + Send + 'static, 

Adds a handler for errors ocurred while polling.

pub const fn poll_interval(self, poll_interval: Duration) -> Self

Configures the minimal interval between making requests. Set to 25ms by default.

pub const fn request_timeout(self, timeout: Duration) -> Self

Configures for how long tbot should wait for getUpdates. If this timeout is exceeded, an error handler is triggered. If you don't configure this value, it is set to Duration::from_secs(timeout.unwrap_or(0) + 60).

pub fn last_n_updates(self, n: NonZeroUsize) -> Self

Configures how many updates tbot will process on start. If configured, tbot sets offset's value to -n when making the first request.

Panics

Panics if n can't be converted to isize safely.

impl<C: Connector + Clone> Polling<C>

pub async fn start(self) -> Result<Infallible, PollingSetup>

Starts the event loop.