CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

unreleased

0.7.0 - 2022-02-09

Changed

• Make DispatcherBuilder::{default_handler, error_handler} accept a handler that implements Send + Sync (PR 517).

0.6.1 - 2022-02-06

Fixed

• docs.rs documentation build

0.6.0 - 2022-02-06

Added

• BotCommand::bot_commands to obtain Telegram API commands (issue 262).
• The dispatching2 and prelude2 modules. They presents a new dispatching model based on dptree.

Changed

• Require that AsUpdateStream::Stream is Send.
• Restrict a user crate by CARGO_CRATE_NAME instead of CARGO_PKG_NAME in enable_logging! and enable_logging_with_filter!.
• Updated teloxide-core to v0.4.0, see its changelog.

Deprecated

• The dispatching and prelude modules.

Fixed

• Infinite retries while stopping polling listener (issue 496)
• polling{,_default} and it's Stream and StopToken not being Send (and by extension fix the same problem with repls)

0.5.3 - 2021-10-25

Fixed

• Compilation when the ctrlc_handler feature is disabled (issue 462)

0.5.2 - 2021-08-25

Fixed

• Depend on a correct futures version (v0.3.15).

0.5.1 - 2021-08-05

Changed

• Improved log messages when ^C is received with ^C handler set up

0.5.0 - 2021-07-08

Added

• Storage::get_dialogue to obtain a dialogue indexed by a chat ID.
• InMemStorageError with a single variant DialogueNotFound to be returned from InMemStorage::remove_dialogue.
• RedisStorageError::DialogueNotFound and SqliteStorageError::DialogueNotFound to be returned from Storage::remove_dialogue.
• A way to shutdown dispatcher
  • Dispatcher::shutdown_token function.
  • ShutdownToken with a shutdown function.
• Dispatcher::setup_ctrlc_handler function (issue 153).
• IdleShutdownError
• Automatic update filtering (issue 389).
• Added reply shortcut to every kind of messages (PR 404).

Changed

• Do not return a dialogue from Storage::{remove_dialogue, update_dialogue}.
• Return an error from Storage::remove_dialogue if a dialogue does not exist.
• Require D: Clone in dialogues_repl(_with_listener) and InMemStorage.
• Automatically delete a webhook if it was set up in update_listeners::polling_default (thereby making it async, issue 319).
• polling and polling_default now require R: 'static
• Refactor UpdateListener trait:
  • Add a StopToken associated type.
    • It must implement a new StopToken trait which has the only function fn stop(self);
  • Add a stop_token function that returns Self::StopToken and allows stopping the listener later (issue 166).
  • Remove blanked implementation.
  • Remove Stream from super traits.
  • Add AsUpdateStream to super traits.
    • Add an AsUpdateStream trait that allows turning implementors into streams of updates (GAT workaround).
  • Add a timeout_hint function (with a default implementation).
• Dispatcher::dispatch and Dispatcher::dispatch_with_listener now require mutable reference to self.
• Repls can now be stopped by ^C signal.
• Noop and AsyncStopTokenstop tokens.
• StatefulListener.
• Emit not only errors but also warnings and general information from teloxide, when set up by enable_logging!.
• Use i64 instead of i32 for user_id in html::user_mention and markdown::user_mention.
• Updated to teloxide-core v0.3.0 (see it's changelog for more)

Fixed

• Remove the reqwest dependency. It's not needed after the teloxide-core integration.
• A storage persistency bug (issue 304).
• Log errors from Storage::{remove_dialogue, update_dialogue} in DialogueDispatcher (issue 302).
• Mark all the functions of Storage as #[must_use].

0.4.0 - 2021-03-22

Added

• Integrate teloxide-core.
• Allow arbitrary error types to be returned from (sub)transitions (issue 242).
• The respond function, a shortcut for ResponseResult::Ok(()).
• The sqlite-storage feature -- enables SQLite support.
• Dispatcher::{my_chat_members_handler, chat_members_handler}

Deprecated

• UpdateWithCx::answer_str

Fixed

• Hide SubtransitionOutputType from the docs.

Changed

• Export teloxide_macros::teloxide in prelude.
• dispatching::dialogue::serializer::{JSON -> Json, CBOR -> Cbor}
• Allow bot_name be N, where N: Into<String> + ... in commands_repl & commands_repl_with_listener.
• 'Edit methods' (namely edit_message_live_location, stop_message_live_location, edit_message_text, edit_message_caption, edit_message_media and edit_message_reply_markup) are split into common and inline versions (e.g.: edit_message_text and edit_inline_message_text). Instead of ChatOrInlineMessage common versions accept chat_id: impl Into<ChatId> and message_id: i32 whereas inline versions accept inline_message_id: impl Into<String>. Also note that return type of inline versions is True (issue 253, pr 257)
• ChatOrInlineMessage is renamed to TargetMessage, it's ::Chat variant is renamed to ::Common, #[non_exhaustive] annotation is removed from the enum, type of TargetMessage::Inline::inline_message_id changed i32 => String. TargetMessage now implements From<String>, get_game_high_scores and set_game_score use Into<TargetMessage> to accept Strings. (issue 253, pr 257)
• Remove ResponseResult from prelude.

0.3.4 - 2020-01-13

Fixed

• Failing compilation with serde::export (issue 328).

0.3.3 - 2020-10-30

Fixed

• The dice field from MessageDice is public now (issue 306)

0.3.2 - 2020-10-23

Added

• LoginUrl::new (issue 298)

0.3.1 - 2020-08-25

Added

• Bot::builder method (PR 269).

0.3.0 - 2020-07-31

Added

• Support for typed bot commands (issue 152).
• BotBuilder, which allows setting a default ParseMode.
• The Transition, Subtransition, SubtransitionOutputType traits.
• A nicer approach to manage dialogues via #[derive(Transition)] + #[teloxide(subtransition)] (see examples/dialogue_bot).
• The redis-storage feature -- enables the Redis support.
• The cbor-serializer feature -- enables the CBOR serializer for dialogues.
• The bincode-serializer feature -- enables the Bincode serializer for dialogues.
• The frunk feature -- enables teloxide::utils::UpState, which allows mapping from a structure of field1, ..., fieldN to a structure of field1, ..., fieldN, fieldN+1.
• Upgrade to v4.9 Telegram bots API.
• teloxide::utils::client_from_env -- constructs a client from the TELOXIDE_TOKEN environmental variable.
• Import Transition, TransitionIn, TransitionOut, UpState to teloxide::prelude.
• Import repl, commands_repl to teloxide.
• Let users inspect an unknown API error using ApiErrorKind::Unknown(String). All the known API errors are placed into KnownApiErrorKind.
• Setters to all the API types.
• teloxide::dispatching::dialogue::serializer -- various serializers for memory storages. The Serializer trait, Bincode, CBOR, JSON.
• teloxide::{repl, repl_with_listener, commands_repl, commands_repl_with_listener, dialogues_repl, dialogues_repl_with_listener}
• InputFile::Memory
• Option to hide a command from description (issue 217).
• Respect the TELOXIDE_PROXY environment variable in Bot::from_env.

Deprecated

• Bot::{from_env_with_client, new, with_client}

Changed

• DialogueDispatcherHandlerCx -> DialogueWithCx.
• DispatcherHandlerCx -> UpdateWithCx.
• Now provided description of unknown telegram error, by splitting ApiErrorKind at ApiErrorKind and ApiErrorKindKnown enums (issue 199).
• Extract Bot from Arc (issue 216).
• Mark all the API types as #[non_exhaustive].
• Replace all mime_type: String with MimeWrapper.

Fixed

• Now methods which can send file to Telegram returns tokio::io::Result<T>. Early its could panic (issue 216).
• If a bot wasn't triggered for several days, it stops responding (issue 223).

0.2.0 - 2020-02-25

Added

• The functionality to parse commands only with a correct bot's name (breaks backwards compatibility) (Issue 168).
• This CHANGELOG.md.

Fixed

• Fix parsing a pinned message (Issue 167).
• Replace LanguageCode with String, because the official Telegram documentation doesn't specify a concrete version of IETF language tag.
• Problems with the poll_type field (Issue 178).
• Make polling_default actually a long polling update listener (PR 182).

Removed

• either from the dependencies in Cargo.toml.
• teloxide-macros migrated into the separate repository to easier releases and testing.

0.1.0 - 2020-02-19

Added

• This project.