Metadata-Version: 2.4
Name: telegram-async
Version: 3.5
Summary: Nowoczesna biblioteka asynchroniczna do Telegram Bot API
Home-page: https://github.com/Denba236/telegram-async
Author: Denys
Author-email: ostrovskyidenys30@gmail.com
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Framework :: AsyncIO
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.8.0
Provides-Extra: redis
Requires-Dist: redis>=4.5.0; extra == "redis"
Provides-Extra: files
Requires-Dist: aiofiles>=22.1.0; extra == "files"
Provides-Extra: rich
Requires-Dist: rich>=12.0.0; extra == "rich"
Provides-Extra: cron
Requires-Dist: croniter>=1.3.0; extra == "cron"
Provides-Extra: ssl
Requires-Dist: cryptography>=36.0.0; extra == "ssl"
Provides-Extra: all
Requires-Dist: redis>=4.5.0; extra == "all"
Requires-Dist: aiofiles>=22.1.0; extra == "all"
Requires-Dist: rich>=12.0.0; extra == "all"
Requires-Dist: croniter>=1.3.0; extra == "all"
Requires-Dist: cryptography>=36.0.0; extra == "all"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Telegram Async

[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue)](https://www.python.org/)
[![aiohttp](https://img.shields.io/badge/aiohttp-latest-green)](https://docs.aiohttp.org/)
[![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)
[![Downloads](https://img.shields.io/pypi/dm/telegram-async)](https://pypi.org/project/telegram-async/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Type checked](https://img.shields.io/badge/types-mypy-brightgreen)](https://mypy-lang.org/)
[![Tests](https://img.shields.io/badge/tests-pytest-yellow)](https://docs.pytest.org/)

An asynchronous Telegram API client library for Python, using `aiohttp` for efficient communication with Telegram servers.

## 👤 Author

**Denys Ostrovskyi**
- 📧 Email: [ostrovskyidenys30@gmail.com](mailto:ostrovskyidenys30@gmail.com)
- 💬 Telegram: [@denbas9](https://t.me/denbas9)
- 💼 GitHub: [@denys-ostrovskyi](https://github.com/Denba236)

## 📋 Table of Contents

- [Features](#-features)
- [Requirements](#-requirements)
- [Installation](#-installation)
- [Quick Start](#-quick-start)
- [Usage Examples](#-usage-examples)
- [Coding Guidelines](#-coding-guidelines)
- [API Documentation](#-api-documentation)
- [Benchmarks](#-benchmarks)
- [Project Structure](#-project-structure)
- [Testing](#-testing)
- [Multilingualism](#-multilingualism)
- [Contribution](#-contribution)
- [License](#-license)
- [Contact and Support](#-contact-and-support)

## ✨ Features

- ✅ **Fully asynchronous** - uses async/await for maximum performance
- ✅ **Official Telegram API support** - full compatibility with Bot API
- ✅ **Session management** - automatic connection renewal
- ✅ **Webhook support** - easy configuration for receiving updates
- ✅ **Multimedia sending** - photos, videos, documents, audio
- ✅ **Inline and reply keyboards** - interactive messages
- ✅ **Rate limiting** - automatic adaptation to API limits
- ✅ **Full typing** - support for IDEs and type checkers
- ✅ **Error handling** - advanced retry system and exception handling
- ✅ **Multilingualism** - support for different languages in bot responses
- ✅ **Middleware** - request processing system
- ✅ **Unit tests** - code coverage >90%

## 🔧 Requirements

- Python 3.7 or later
- aiohttp >= 3.8.0
- Telegram bot account (token from [@BotFather](https://t.me/botfather))

## 📦 Installation

### Installation from PyPI
```bash
pip install telegram-async
```
