Aiogram

===================

Features
--------

- Added full support of `Bot API 7.0 <https://core.telegram.org/bots/api-changelog#december-29-2023>`_

- Reactions
- Replies 2.0
- Link Preview Customization
- Block Quotation
- Multiple Message Actions
- Requests for multiple users
- Chat Boosts
- Giveaway
- Other changes
`1387 <https://github.com/aiogram/aiogram/issues/1387>`_

===================

Features
--------

- Introduced Scenes feature that helps you to simplify user interactions using Finite State Machine.
Read more about 👉 :ref:`Scenes <Scenes>`.
`1280 <https://github.com/aiogram/aiogram/issues/1280>`_
- Added the new FSM strategy :code:`CHAT_TOPIC`, which sets the state for the entire topic in the chat, also works in private messages and regular groups without topics.
`1343 <https://github.com/aiogram/aiogram/issues/1343>`_


Bugfixes
--------

- Fixed :code:`parse_mode` argument in the in :code:`Message.send_copy` shortcut. Disable by default.
`1332 <https://github.com/aiogram/aiogram/issues/1332>`_
- Added ability to get handler flags from filters.
`1360 <https://github.com/aiogram/aiogram/issues/1360>`_
- Fixed a situation where a :code:`CallbackData` could not be parsed without a default value.
`1368 <https://github.com/aiogram/aiogram/issues/1368>`_


Improved Documentation
----------------------

- Corrected grammatical errors, improved sentence structures, translation for migration 2.x-3.x
`1302 <https://github.com/aiogram/aiogram/issues/1302>`_
- Minor typo correction, specifically in module naming + some grammar.
`1340 <https://github.com/aiogram/aiogram/issues/1340>`_
- Added `CITATION.cff` file for automatic academic citation generation.
Now you can copy citation from the GitHub page and paste it into your paper.
`1351 <https://github.com/aiogram/aiogram/issues/1351>`_
- Minor typo correction in middleware docs.
`1353 <https://github.com/aiogram/aiogram/issues/1353>`_


Misc
----

- Fixed ResourceWarning in the tests, reworked :code:`RedisEventsIsolation` fixture to use Redis connection from :code:`RedisStorage`
`1320 <https://github.com/aiogram/aiogram/issues/1320>`_
- Updated dependencies, bumped minimum required version:

- :code:`magic-filter` - fixed `.resolve` operation
- :code:`pydantic` - fixed compatibility (broken in 2.4)
- :code:`aiodns` - added new dependency to the :code:`fast` extras (:code:`pip install aiogram[fast]`)
- *others...*
`1327 <https://github.com/aiogram/aiogram/issues/1327>`_
- Prevent update handling task pointers from being garbage collected, backport from 2.x
`1331 <https://github.com/aiogram/aiogram/issues/1331>`_
- Updated :code:`typing-extensions` package version range in dependencies to fix compatibility with :code:`FastAPI`
`1347 <https://github.com/aiogram/aiogram/issues/1347>`_
- Introduce Python 3.12 support
`1354 <https://github.com/aiogram/aiogram/issues/1354>`_
- Speeded up CallableMixin processing by caching references to nested objects and simplifying kwargs assembly.
`1357 <https://github.com/aiogram/aiogram/issues/1357>`_
- Added :code:`pydantic` v2.5 support.
`1361 <https://github.com/aiogram/aiogram/issues/1361>`_
- Updated :code:`thumbnail` fields type to :code:`InputFile` only
`1372 <https://github.com/aiogram/aiogram/issues/1372>`_

===================

Bugfixes
--------

- Fixed `pydantic` version <2.4, since 2.4 has breaking changes.
`1322 <https://github.com/aiogram/aiogram/issues/1322>`_

===================

Features
--------

- Added support for custom encoders/decoders for payload (and also for deep-linking).
`1262 <https://github.com/aiogram/aiogram/issues/1262>`_
- Added :class:`aiogram.utils.input_media.MediaGroupBuilder` for media group construction.
`1293 <https://github.com/aiogram/aiogram/issues/1293>`_
- Added full support of `Bot API 6.9 <https://core.telegram.org/bots/api-changelog#september-22-2023>`_
`1319 <https://github.com/aiogram/aiogram/issues/1319>`_


Bugfixes
--------

- Added actual param hints for `InlineKeyboardBuilder` and `ReplyKeyboardBuilder`.
`1303 <https://github.com/aiogram/aiogram/issues/1303>`_
- Fixed priority of events isolation, now user state will be loaded only after lock is acquired
`1317 <https://github.com/aiogram/aiogram/issues/1317>`_

===================

Bugfixes
--------

- Replaced :code:`datetime.datetime` with `DateTime` type wrapper across types to make dumped JSONs object
more compatible with data that is sent by Telegram.
`1277 <https://github.com/aiogram/aiogram/issues/1277>`_
- Fixed magic :code:`.as_(...)` operation for values that can be interpreted as `False` (e.g. `0`).
`1281 <https://github.com/aiogram/aiogram/issues/1281>`_
- Italic markdown from utils now uses correct decorators
`1282 <https://github.com/aiogram/aiogram/issues/1282>`_
- Fixed method :code:`Message.send_copy` for stickers.
`1284 <https://github.com/aiogram/aiogram/issues/1284>`_
- Fixed :code:`Message.send_copy` method, which was not working properly with stories, so not you can copy stories too (forwards messages).
`1286 <https://github.com/aiogram/aiogram/issues/1286>`_
- Fixed error overlapping when validation error is caused by remove_unset root validator in base types and methods.
`1290 <https://github.com/aiogram/aiogram/issues/1290>`_

======================

Bugfixes
--------

- Fixed missing message content types (:code:`ContentType.USER_SHARED`, :code:`ContentType.CHAT_SHARED`)
`1252 <https://github.com/aiogram/aiogram/issues/1252>`_
- Fixed nested hashtag, cashtag and email message entities not being parsed correctly when these entities are inside another entity.
`1259 <https://github.com/aiogram/aiogram/issues/1259>`_
- Moved global filters check placement into router to add chance to pass context from global filters
into handlers in the same way as it possible in other places
`1266 <https://github.com/aiogram/aiogram/issues/1266>`_


Improved Documentation
----------------------

- Added error handling example `examples/error_handling.py`
`1099 <https://github.com/aiogram/aiogram/issues/1099>`_
- Added a few words about skipping pending updates
`1251 <https://github.com/aiogram/aiogram/issues/1251>`_
- Added a section on Dependency Injection technology
`1253 <https://github.com/aiogram/aiogram/issues/1253>`_
- This update includes the addition of a multi-file bot example to the repository.
`1254 <https://github.com/aiogram/aiogram/issues/1254>`_
- Refactored examples code to use aiogram enumerations and enhanced chat messages with markdown
beautification's for a more user-friendly display.
`1256 <https://github.com/aiogram/aiogram/issues/1256>`_
- Supplemented "Finite State Machine" section in Migration FAQ
`1264 <https://github.com/aiogram/aiogram/issues/1264>`_
- Removed extra param in docstring of TelegramEventObserver's filter method
and fixed typo in I18n documentation.
`1268 <https://github.com/aiogram/aiogram/issues/1268>`_


Misc
----

- Enhanced the warning message in dispatcher to include a JSON dump of the update when update type is not known.
`1269 <https://github.com/aiogram/aiogram/issues/1269>`_
- Added support for `Bot API 6.8 <https://core.telegram.org/bots/api-changelog#august-18-2023>`_
`1275 <https://github.com/aiogram/aiogram/issues/1275>`_