Struct tbot::event_loop::Polling

pub struct Polling { /* private fields */ }

Configures and starts polling.

To construct Polling, use EventLoop::polling.

Implementations

impl Polling

pub fn into_stateful<S>(self, state: S) -> Polling<S>where
    S: Send + Sync + 'static,

Turns this polling into a stateful one. Previous configuration

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

Configures the limit of updates per request.

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

Configures the timeout for long polling.

pub const fn allowed_updates(self, allowed_updates: AllowedUpdates) -> Self

Configures which updates you’d like to listen to.

pub fn error_handler<H, F>(self, handler: H) -> Selfwhere
    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, the 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 Polling

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

Starts the event loop.