Release Notes#

Release notes for Pyrogram releases will describe what’s new in each version, and will also make you aware of any backwards-incompatible changes made in that version.

A Word of Warning

We merge changes made to few of pyrogram forks plus changes made by us to this repository. All the features are just customized feature mostly for personal use; there is no guarantee in them being stable, USE AT YOUR OWN RISK.

When upgrading to a new version of Pyrogram, you will need to check all the changes in order to find incompatible code in your application, but also to take advantage of new features and improvements.

This page lists all the documented changes of this fork, in reverse chronological order. You should read this when upgrading to this fork to know where your code can break, and where it can take advantage of new goodies!

For a more detailed description, please check the commits.

If you found any issue or have any suggestions, feel free to make an issue on github.

Breaking Changes in this Fork

  • In copy_message(), ValueError is raised instead of logging it.

  • In download_media(), if the message is a PaidMediaInfo with more than one paid_media and idx was not specified, then a list of paths or binary file-like objects is returned.

  • PR #115 This change breaks some usages with offset-naive and offset-aware datetimes.

  • PR from upstream #1411: Rename some of the attributes of MessagesFilter for consistency.

  • If you relied on internal types like import pyrogram.file_id OR import pyrogram.utils, Then read this full document to know where else your code will break.

  • InlineKeyboardButton only accepts keyword arguments instead of positional arguments.