Skip to main content

Thin wrapper around Telegram Bot API

Project description

Tg API

PyPI - Downloads PyPI - License

Библиотека Tg API упрощает работу с веб-API Telegram. Она предоставляет тонкую обёртку над веб API Telegram и библиотекой HTTPX. Библиотека Tg API добавляет к обычным возможностям HTTPX свои схемы данных и удобные часто используемые функции, но не мешает, при необходимости, спускаться ниже на уровень HTTP-запросов.

Пример отправки пользователю текстового сообщения:

from tg_api import SyncTgClient, SendMessageRequest


with SyncTgClient.setup(token):
    tg_request = SendMessageRequest(chat_id=tg_chat_id, text='Message proofs high level usage.')
    tg_request.send()

Ключевые возможности библиотеки

Ключевые возможности библиотеки Tg API:

  • Поддержка синхронных и асинхронных запросов к API
  • Shortcuts для часто используемых запросов
  • Лёгкий доступ к боту из любого места в коде
  • Наглядные схемы данных для всех типов запросов и ответов API
  • Аннотация типов для удобства работы с IDE
  • Простое низкоуровневое API для кастомизации запросов к API
  • Набор инструментов для удобной работы с исключениями

Как установить

Библиотека доступна на PyPI:

$ python -m pip install tg-api

Поддерживаемые версии Python и зависимостей

Поддерживаются:

  • Python 3.10 и старше
  • pydantic 1.10.0 и старше, но только первой версии 1.x
  • httpx 0.24.1 и старше

Документация

Документация доступна на Read the Docs: https://tg-api.readthedocs.io/en/latest/.

Разработчикам библиотеки Tg API

Инструкции и справочная информация для разработчиков библиотеки Tg API собраны в отдельном документе CONTRIBUTING.md.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tg_api-1.5.0.tar.gz (27.0 kB view details)

Uploaded Source

Built Distribution

tg_api-1.5.0-py3-none-any.whl (27.1 kB view details)

Uploaded Python 3

File details

Details for the file tg_api-1.5.0.tar.gz.

File metadata

  • Download URL: tg_api-1.5.0.tar.gz
  • Upload date:
  • Size: 27.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for tg_api-1.5.0.tar.gz
Algorithm Hash digest
SHA256 0d2390e9e56e72a513ff8a1052fe8146de76a05164f992a0ff69f777d0774b91
MD5 25ea567433fbdfce4f08a60b0b57617c
BLAKE2b-256 c2cbf278719f0d685b29175913dd424dcdefbe07868a2d141e466dfdd1b12374

See more details on using hashes here.

File details

Details for the file tg_api-1.5.0-py3-none-any.whl.

File metadata

  • Download URL: tg_api-1.5.0-py3-none-any.whl
  • Upload date:
  • Size: 27.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for tg_api-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c6140f95f0227d9fe8497b55d3dcd653bba67f4e3590fc29a7bafaed87a1f942
MD5 12d00760ac0e008963a6f40b65cb1242
BLAKE2b-256 1aea0e19736f1e4a75e1ceaa0ecd923b362a74dc98a358024950b60695cccb51

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page