teloxide/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.11.0 - 2022-10-07

Changed

• Updated teloxide-macros to v0.7.0; see its changelog for more
• Updated teloxide-core to v0.8.0; see its changelog for more
• UpdateListener now has an associated type Err instead of a generic
• AsUpdateStream now has an associated type StreamErr instead of a generic
• Rename dispatching::stop_token::{AsyncStopToken, AsyncStopFlag} => stop::{StopToken, StopFlag}
• Replace the generic error type E with RequestError for REPLs (repl(_with_listener), commands_repl(_with_listener))
• The following functions are now #[must_use]:
  • BotCommands::ty.
  • CommandDescriptions::{new, global_description, username, username_from_me}.
  • teloxide::filter_command.
  • teloxide::dispatching::dialogue::enter.
• BotCommands::parse now accept bot_username as &str

Added

• requests::ResponseResult to prelude

Removed

• dispatching::stop_token::StopToken trait (all uses are replaced with stop::StopToken structure)
• Some previously deprecated items
  • enable_logging!, enable_logging_with_filter!
  • HandlerFactory, HandlerExt::dispatch_by

0.10.1 - 2022-07-22

Fixed

• Mark the following functions with #[must_use] (PR 457):
  • TraceStorage::into_inner.
  • AsyncStopToken::new_pair.
  • AsyncStopFlag::is_stopped.
  • All from crate::utils::{html, markdown}.
• Rendering of GIFs in lib.rs and crates.io (PR 681).

0.10.0 - 2022-07-21

Added

• Security checks based on secret_token param of set_webhook to built-in webhooks.
• dispatching::update_listeners::{PollingBuilder, Polling, PollingStream}.
• DispatcherBuilder::enable_ctrlc_handler method.

Fixed

• Dispatcher no longer "leaks" memory for every inactive user (PR 657).
• Allow specifying a path to a custom command parser in parse_with (issue 668).

Changed

• Add the Key: Clone requirement for impl Dispatcher [BC].
• dispatching::update_listeners::{polling_default, polling} now return a named, Polling<_> type.
• Update teloxide-core to v0.7.0 with Bot API 6.1 support, see its changelog for more information [BC].

Deprecated

• The dispatching::update_listeners::polling function.
• Dispatcher::setup_ctrlc_handler method.

0.9.2 - 2022-06-07

Fixed

• Fix Api Unknown error (Can't parse entities) on message created with utils::markdown::user_mention_or_link if user full name contains some escapable symbols eg '.'

0.9.1 - 2022-05-27

Fixed

• Fix #[command(rename = "...")] for custom command names (issue 633).

0.9.0 - 2022-04-27

Added

• The dispatching::filter_command function (also accessible as teloxide::filter_command) as a shortcut for dptree::entry().filter_command().
• Re-export dptree::case! as teloxide::handler! (the former is preferred for new code).

Changed

• Update teloxide-core to v0.6.0 with Bot API 6.0 support [BC].

0.8.2 - 2022-04-26

Fixed

• Fix the broken #[derive(DialogueState)] (function return type dptree::Handler).

0.8.1 - 2022-04-24

Added

• Implement GetChatId for Update.
• The dialogue::enter() function as a shortcut for dptree::entry().enter_dialogue().

0.8.0 - 2022-04-18

Removed

• The old dispatching system and related stuff: dispatching, utils::UpState, prelude, repls2, crate::{dialogues_repl, dialogues_repl_with_listener}, and #[teloxide(subtransition)] [BC].

Added

• The new API for dialogue handlers: teloxide::handler! (issue 567).
• Built-in webhooks support via teloxide::dispatching::update_listeners::webhooks module.
• Dialogue::chat_id for retrieving a chat ID from a dialogue.

Changed

• Updated teloxide-core from version 0.4.5 to version 0.5.0 [BC]
• Rename dispatching2 => dispatching [BC].
• Rename prelude2 => prelude [BC].
• Move update_listeners, stop_token, IdleShutdownError, and ShutdownToken from the old dispatching to the new dispatching (previously dispatching2).
• Replace crate::{commands_repl, commands_repl_with_listener, repl, repl_with_listener} with those of the new dispatching [BC].
• UpdateListener::StopToken is now always Send [BC].
• Rename BotCommand trait to BotCommands [BC].
• BotCommands::descriptions now returns CommandDescriptions instead of String [BC].
• Mark Dialogue::new as #[must_use].

Fixed

• Concurrent update handling in the new dispatcher (issue 536).

Deprecated

• HandlerFactory and HandlerExt::dispatch_by in favour of teloxide::handler!.

0.7.3 - 2022-04-03

Fixed

• Update teloxide-core to version 0.4.5 to fix a security vulnerability. See more in teloxide-core release notes.

0.7.2 - 2022-03-23

Added

• The Storage::erase default function that returns Arc<ErasedStorage>.
• ErasedStorage, a storage with an erased error type.
• Allow the storage generic S be ?Sized in Dialogue and HandlerExt::enter_dialogue.

Deprecated

• enable_logging! and enable_logging_with_filter! macros

Fixed

• Log UpdateKind::Error in teloxide::dispatching2::Dispatcher.
• Don't warn about unhandled updates in repls2 (issue 557).
• parse_command and parse_command_with_prefix now ignores case of the bot username

0.7.1 - 2022-03-09

Fixed

• Compilation with non-default features

0.7.0 - 2022-02-09

Fixed

• Dispatcher wasn't Send. 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 present 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 persistence 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 return tokio::io::Result<T>. Before that it 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.