Skip to content

v0.3

tagged this 14 Jun 14:26
feature parity with the upstream Telegram API (except for keyboards and
inlines), including the new features in the Bot API 2.0 and 2.1 updates,
such as moderating group chats or editing messages.

Performance are improved, with a faster updates fetching process, and a
bug was fixed in this release. There are also a few deprecations to keep
the API clean.  All the deprecated features in this release will be
removed in botogram 1.0, so you have plenty of time to switch to the new
ones.

New features
------------

* Added the ability to react when a chat is not available:

   * New decorator `botogram.Bot.chat_unavailable`
   * New method `botogram.Component.add_chat_unavailable_hook`

* Added support for editing messages sent by the bot:

   * New method `botogram.Message.edit`
   * New method `botogram.Message.edit_caption`
   * New method `botogram.Bot.edit_message`
   * New method `botogram.Bot.edit_caption`

* Added support for working with parsed text in a message:

   * New attribute `botogram.Message.parsed_text`
   * New class `botogram.ParsedText`
   * New class `botogram.ParsedTextEntity`

* Added a new way to hide commands from the `/help` command:

   * New argument `hidden` on `botogram.Bot.command`
   * New argument `hidden` on `botogram.Component.add_command`

* Added support for processing edited messages:

   * New decorator `botogram.Bot.message_edited`
   * New method `botogram.Component.add_message_edited_hook`

* Added support for moderating groups:

   * New method `botogram.Chat.ban`
   * New method `botogram.Chat.unban`

* Added support for sending contacts:

   * New method `botogram.User.send_contact`
   * New method `botogram.Chat.send_contact`
   * New method `botogram.Message.reply_with_contact`

* Added support for venues:

   * New class `botogram.Venue`
   * New attrinute `botogram.Message.venue`
   * New method `botogram.User.send_venue`
   * New method `botogram.Chat.send_venue`
   * New method `botogram.Message.reply_with_venue`

* Added new attribute `botogram.Message.pinned_message`
* Added new attribute `botogram.Sticker.emoji`
* Added new attribute `botogram.Chat.admins`
* Added new attribute `botogram.Chat.creator`
* Added new attribute `botogram.Chat.members_count`
* Added new method `botogram.Chat.status_of`
* Added new method `botogram.Chat.leave`
* Added new method `botogram.Bot.chat`
* Every method which sends something to a chat now returns the sent
  `~botogram.Message`
* Multiple instances of the same bot are now properly handled (as
  errors)
* It's now possible to correctly compare API objects

Changes
-------

* Renamed `Message.new_chat_participant` to
  `botogram.Message.new_chat_member`
* Renamed `Message.left_chat_participant` to
  `botogram.Message.left_chat_member`
* `botogram.Message.forward_from` can now be either an instance of
  `botogram.User` or `botogram.Chat`

Performance improvements
------------------------

* Updates queueing performance improved
* Backlog processing is now instantaneous

Bug fixes
---------

* Fix docstrings not escaped in the `/help` command if no syntax was
  used (GH-67)

   * Now docstrings are escaped if you don't use any HTML syntax in
     them, but if you use HTML you need to manually escape that
     specific docstring.

Deprecated features
-------------------

Deprecated features will be removed in botogram 1.0!

* `Message.new_chat_participant` is now deprecated
* `Message.left_chat_participant` is now deprecated
* `Bot.hide_commands` is now deprecated
* `Bot.send` is now deprecated
* `Bot.send_photo` is now deprecated
* `Bot.send_audio` is now deprecated
* `Bot.send_voice` is now deprecated
* `Bot.send_video` is now deprecated
* `Bot.send_file` is now deprecated
* `Bot.send_location` is now deprecated
* `Bot.send_sticker` is now deprecated
Assets 2
Loading