Metadata-Version: 2.4
Name: litegram
Version: 1.0.8
Summary: Modern and fully asynchronous framework for Telegram Bot API
Project-URL: Homepage, https://litegram.dev/
Project-URL: Documentation, https://litegram.readthedocs.io/
Project-URL: Repository, https://github.com/litegram/litegram/
Author-email: Ruslan Samoylov <ruslan@samoylov.tech>
Maintainer-email: Ruslan Samoylov <ruslan@samoylov.tech>
License-Expression: MIT
License-File: LICENSE
Keywords: api,asyncio,bot,framework,telegram,wrapper
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.13
Requires-Dist: aiofiles<26.0,>=25.1
Requires-Dist: certifi>=2026.1.4
Requires-Dist: httpx<0.29,>=0.27
Requires-Dist: litestar<3.0,>=2.19
Requires-Dist: pydantic<2.13,>=2.12
Requires-Dist: typing-extensions<=5.0,>=4.15.0
Provides-Extra: cli
Requires-Dist: litestar[cli]; extra == 'cli'
Requires-Dist: rich-click>=1.8.5; extra == 'cli'
Requires-Dist: shellingham>=1.5.4; extra == 'cli'
Provides-Extra: cryptography
Requires-Dist: litestar[cryptography]; extra == 'cryptography'
Provides-Extra: docs
Requires-Dist: furo>=2025.12.19; extra == 'docs'
Requires-Dist: markdown-include>=0.8.1; extra == 'docs'
Requires-Dist: pygments>=2.19; extra == 'docs'
Requires-Dist: pymdown-extensions>=10.20; extra == 'docs'
Requires-Dist: sphinx-autobuild>=2025.8.25; extra == 'docs'
Requires-Dist: sphinx-copybutton>=0.5.2; extra == 'docs'
Requires-Dist: sphinx-intl>=2.3; extra == 'docs'
Requires-Dist: sphinx-substitution-extensions>=2026.1.12; extra == 'docs'
Requires-Dist: sphinx>=9.1; extra == 'docs'
Requires-Dist: sphinxcontrib-towncrier>=0.5.0a0; extra == 'docs'
Requires-Dist: towncrier>=25.8.0; extra == 'docs'
Provides-Extra: fast
Requires-Dist: httptools>=0.6.4; extra == 'fast'
Requires-Dist: uvloop>=0.22.1; ((sys_platform == 'darwin' or sys_platform == 'linux') and platform_python_implementation != 'PyPy') and extra == 'fast'
Provides-Extra: i18n
Requires-Dist: babel<3,>=2.17; extra == 'i18n'
Provides-Extra: mongo
Requires-Dist: motor<3.8,>=3.7; extra == 'mongo'
Requires-Dist: pymongo<4.17,>=4.10; extra == 'mongo'
Provides-Extra: proxy
Requires-Dist: httpx-socks~=0.11; extra == 'proxy'
Provides-Extra: redis
Requires-Dist: litestar[redis]; extra == 'redis'
Provides-Extra: signature
Requires-Dist: litestar[cryptography]; extra == 'signature'
Provides-Extra: speedups
Requires-Dist: httptools>=0.6.4; extra == 'speedups'
Requires-Dist: uvloop>=0.22.1; ((sys_platform == 'darwin' or sys_platform == 'linux') and platform_python_implementation != 'PyPy') and extra == 'speedups'
Description-Content-Type: text/x-rst

########
litegram
########

.. image:: https://img.shields.io/pypi/l/litegram?style=flat-square
    :target: https://opensource.org/licenses/MIT
    :alt: MIT License

.. image:: https://img.shields.io/pypi/status/litegram?style=flat-square
    :target: https://pypi.python.org/pypi/litegram
    :alt: PyPi status

.. image:: https://img.shields.io/pypi/v/litegram?style=flat-square
    :target: https://pypi.python.org/pypi/litegram
    :alt: PyPi Package Version

.. image:: https://img.shields.io/pypi/dm/litegram?style=flat-square
    :target: https://pypi.python.org/pypi/litegram
    :alt: Downloads

.. image:: https://img.shields.io/pypi/pyversions/litegram?style=flat-square
    :target: https://pypi.python.org/pypi/litegram
    :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%2Flitegram%2Flitegram%2Fmaster%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/litegram/litegram/tests.yml?branch=master&style=flat-square
    :target: https://github.com/litegram/litegram/actions
    :alt: Tests

.. image:: https://img.shields.io/codecov/c/github/litegram/litegram?style=flat-square
    :target: https://app.codecov.io/gh/litegram/litegram
    :alt: Codecov

**litegram** is a modern and fully asynchronous framework for
`Telegram Bot API <https://core.telegram.org/bots/api>`_ written in Python 3.13+ using
`litestar <https://github.com/litestar-org/litestar>`_ and
`httpx <https://github.com/encode/httpx>`_.

Make your bots faster and more powerful!

Documentation:
 - 🇷🇺 `Russian <https://litegram.readthedocs.io/ru/latest/>`_
 - 🇺🇸 `English <https://litegram.readthedocs.io/en/latest/>`_


Features
========

- Asynchronous (`asyncio docs <https://docs.python.org/3/library/asyncio.html>`_, :pep:`492`)
- Has type hints (:pep:`484`) and can be used with `ty <https://github.com/astral-sh/ty>`_
- Supports `Telegram Bot API 9.3 <https://core.telegram.org/bots/api>`_ and gets fast updates to the latest versions of the Bot API
- Updates router (Blueprints)
- Has Finite State Machine
- Uses powerful `magic filters <https://litegram.readthedocs.io/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 **litegram**.

    If you have any questions, you can visit our community chats on Telegram:

    - 🇷🇺 `@litegram_ru <https://t.me/litegram_ru>`_
    - 🇺🇸 `@litegram_en <https://t.me/litegram_en>`_
