Struct TelegramSettingsBuilder 

pub struct TelegramSettingsBuilder { /* private fields */ }

Builds a TelegramSettings.

Implementations

impl TelegramSettingsBuilder

pub fn new(token: impl Into<String>) -> Self

Creates a builder for the given bot token.

pub fn base_url(self, base_url: impl Into<String>) -> Self

Overrides the API base URL.

Intended for pointing tests at a local mock server, or for a self-hosted Bot API server. Production should leave this at its default.

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

Overrides the connection timeout.

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

Overrides the total request timeout.

pub const fn queue_capacity(self, capacity: usize) -> Self

Overrides how many messages are held per chat before sends are dropped.

pub const fn max_chunks(self, max_chunks: usize) -> Self

Overrides how many messages one oversized message may become.

pub const fn max_input_bytes(self, max_bytes: usize) -> Self

Overrides the largest message accepted, in bytes.

pub const fn max_retries(self, retries: u32) -> Self

Overrides how many times a transient failure is retried.

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

Overrides the longest retry_after which will be honored.

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

Overrides the minimum spacing between messages to the same chat.

pub const fn global_per_second(self, per_second: u32) -> Self

Overrides the ceiling on messages per second across all chats.

pub fn build(self) -> Result<TelegramSettings, TelegramError>

Validates and finalizes the settings.

Errors

Returns TelegramError::InvalidToken if the token is blank or malformed. A blank-but-present token is treated as missing, because a server which boots with one looks healthy while notifying nobody.

Trait Implementations

impl Clone for TelegramSettingsBuilder

fn clone(&self) -> TelegramSettingsBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TelegramSettingsBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.