mirror of
https://github.com/aiogram/aiogram.git
synced 2026-04-08 16:37:47 +00:00
49d0784e33
* Bump API schema to version 9.4, add new object types, methods, and properties.
* Add tests for `ChatOwnerChanged` and `ChatOwnerLeft` message types
* Add tests for `GetUserProfileAudios`, `RemoveMyProfilePhoto`, and `SetMyProfilePhoto` methods
* Bump version
* Update Makefile variables and refactor `test_get_user_profile_audios.py`
* Document new features and updates from Bot API 9.4 in changelog
* Add `ButtonStyle` enum to represent button styles in the Telegram API
* Fix review issues from PR #1761
- Remove stray '-' artifact from GameHighScore docstring and butcher schema
- Fix Makefile reformat target scope inconsistency (ruff check --fix)
- Fix ButtonStyle enum source URL (#chat -> #inlinekeyboardbutton)
- Add User.get_profile_audios() shortcut method (parallel to get_profile_photos)
- Test ChatOwnerLeft with new_owner=None (edge case)
- Add VideoQuality type and Video.qualities nesting tests
- Add User.get_profile_audios() test
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Revert "Fix review issues from PR #1761"
This reverts commit 2184e98988.
* Update source links for `ButtonStyle` documentation to reflect accurate API references
* Fix review issues from PR #1761 (#1762)
* Fix review issues from PR #1761
- Remove stray '-' artifact from GameHighScore docstring
- Fix Makefile reformat target scope inconsistency (ruff check --fix)
- Add User.get_profile_audios() shortcut method (parallel to get_profile_photos)
- Test ChatOwnerLeft with new_owner=None (edge case)
- Add VideoQuality type and Video.qualities nesting tests
- Add User.get_profile_audios() test
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Address review comments: use fixture and variables in tests, add changelog
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Address review follow-ups for PR #1762
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* Reformat code
* Shut up, ruff
---------
Co-authored-by: latand <latand666@gmail.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Kostiantyn Kriuchkov <36363097+Latand@users.noreply.github.com>
80 lines
3.5 KiB
ReStructuredText
80 lines
3.5 KiB
ReStructuredText
#######
|
|
aiogram
|
|
#######
|
|
|
|
.. image:: https://img.shields.io/pypi/l/aiogram.svg?style=flat-square
|
|
:target: https://opensource.org/licenses/MIT
|
|
:alt: MIT License
|
|
|
|
.. image:: https://img.shields.io/pypi/status/aiogram.svg?style=flat-square
|
|
:target: https://pypi.python.org/pypi/aiogram
|
|
:alt: PyPi status
|
|
|
|
.. image:: https://img.shields.io/pypi/v/aiogram.svg?style=flat-square
|
|
:target: https://pypi.python.org/pypi/aiogram
|
|
:alt: PyPi Package Version
|
|
|
|
.. image:: https://img.shields.io/pypi/dm/aiogram.svg?style=flat-square
|
|
:target: https://pypi.python.org/pypi/aiogram
|
|
:alt: Downloads
|
|
|
|
.. image:: https://img.shields.io/pypi/pyversions/aiogram.svg?style=flat-square
|
|
:target: https://pypi.python.org/pypi/aiogram
|
|
:alt: Supported python versions
|
|
|
|
.. image:: https://img.shields.io/badge/dynamic/json?color=blue&logo=telegram&label=Telegram%20Bot%20API&query=%24.api.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Faiogram%2Faiogram%2Fdev-3.x%2F.butcher%2Fschema%2Fschema.json&style=flat-square
|
|
:target: https://core.telegram.org/bots/api
|
|
:alt: Telegram Bot API
|
|
|
|
.. image:: https://img.shields.io/github/actions/workflow/status/aiogram/aiogram/tests.yml?branch=dev-3.x&style=flat-square
|
|
:target: https://github.com/aiogram/aiogram/actions
|
|
:alt: Tests
|
|
|
|
.. image:: https://img.shields.io/codecov/c/github/aiogram/aiogram?style=flat-square
|
|
:target: https://app.codecov.io/gh/aiogram/aiogram
|
|
:alt: Codecov
|
|
|
|
**aiogram** is a modern and fully asynchronous framework for
|
|
`Telegram Bot API <https://core.telegram.org/bots/api>`_ written in Python 3.10+ using
|
|
`asyncio <https://docs.python.org/3/library/asyncio.html>`_ and
|
|
`aiohttp <https://github.com/aio-libs/aiohttp>`_.
|
|
|
|
Make your bots faster and more powerful!
|
|
|
|
Documentation:
|
|
- 🇺🇸 `English <https://docs.aiogram.dev/en/dev-3.x/>`_
|
|
- 🇺🇦 `Ukrainian <https://docs.aiogram.dev/uk_UA/dev-3.x/>`_
|
|
|
|
|
|
Features
|
|
========
|
|
|
|
- Asynchronous (`asyncio docs <https://docs.python.org/3/library/asyncio.html>`_, :pep:`492`)
|
|
- Has type hints (:pep:`484`) and can be used with `mypy <http://mypy-lang.org/>`_
|
|
- Supports `PyPy <https://www.pypy.org/>`_
|
|
- Supports `Telegram Bot API 9.4 <https://core.telegram.org/bots/api>`_ and gets fast updates to the latest versions of the Bot API
|
|
- Telegram Bot API integration code was `autogenerated <https://github.com/aiogram/tg-codegen>`_ and can be easily re-generated when API gets updated
|
|
- Updates router (Blueprints)
|
|
- Has Finite State Machine
|
|
- Uses powerful `magic filters <https://docs.aiogram.dev/en/latest/dispatcher/filters/magic_filters.html#magic-filters>`_
|
|
- Middlewares (incoming updates and API calls)
|
|
- Provides `Replies into Webhook <https://core.telegram.org/bots/faq#how-can-i-make-requests-in-response-to-updates>`_
|
|
- Integrated I18n/L10n support with GNU Gettext (or Fluent)
|
|
|
|
|
|
.. warning::
|
|
|
|
It is strongly advised that you have prior experience working
|
|
with `asyncio <https://docs.python.org/3/library/asyncio.html>`_
|
|
before beginning to use **aiogram**.
|
|
|
|
If you have any questions, you can visit our community chats on Telegram:
|
|
|
|
- 🇺🇸 `@aiogram <https://t.me/aiogram>`_
|
|
- 🇺🇦 `@aiogramua <https://t.me/aiogramua>`_
|
|
- 🇺🇿 `@aiogram_uz <https://t.me/aiogram_uz>`_
|
|
- 🇰🇿 `@aiogram_kz <https://t.me/aiogram_kz>`_
|
|
- 🇷🇺 `@aiogram_ru <https://t.me/aiogram_ru>`_
|
|
- 🇮🇷 `@aiogram_fa <https://t.me/aiogram_fa>`_
|
|
- 🇮🇹 `@aiogram_it <https://t.me/aiogram_it>`_
|
|
- 🇧🇷 `@aiogram_br <https://t.me/aiogram_br>`_
|