Metadata-Version: 2.4
Name: elystl
Version: 1.0.0
Summary: Pure Python 3 MTProto Telegram API framework for Elys Userbot (based on Telethon)
Author-email: ZavozDevs <zavozdevs@users.noreply.github.com>
License: MIT
Project-URL: Homepage, https://github.com/ZavozDevs/elystl
Project-URL: Source, https://github.com/ZavozDevs/elystl
Project-URL: Bug Tracker, https://github.com/ZavozDevs/elystl/issues
Keywords: api,chat,client,library,messaging,mtproto,telegram,elys
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: pyaes
Requires-Dist: rsa
Requires-Dist: bs4==0.0.2
Provides-Extra: cryptg
Requires-Dist: cryptg; extra == "cryptg"
Provides-Extra: tgcrypto
Requires-Dist: TgCrypto-pyrofork; extra == "tgcrypto"
Dynamic: license-file

# ElysTL (elystl)

> 🪐 MTProto Telegram API framework for Elys Userbot, based on Telethon.

[![PyPI](https://img.shields.io/pypi/v/elystl.svg)](https://pypi.org/project/elystl/)
[![GitHub](https://img.shields.io/github/license/ZavozDevs/elystl)](LICENSE.md)

**ElysTL** is an asyncio Python 3 MTProto library to interact with Telegram API as a user or bot account, optimized for high performance, custom formatting, and reliability in userbot environments.

## Installation

```bash
pip install elystl
```

Or install from GitHub:

```bash
pip install git+https://github.com/ZavozDevs/elystl.git
```

## Quick Start

```python
from elystl import TelegramClient, events

api_id = 12345
api_hash = "your_api_hash"

client = TelegramClient("session_name", api_id, api_hash)

@client.on(events.NewMessage(pattern=r"(?i)ping"))
async def handler(event):
    await event.respond("pong!")

client.start()
client.run_until_disconnected()
```

## Credits & Acknowledgements

- **[Herokutl](https://pypi.org/project/herokutl/)** by [Codrago](https://github.com/coddrago) — the direct predecessor and foundation of this library.
- **[Telethon](https://github.com/LonamiWebs/Telethon)** by [LonamiWebs](https://github.com/Lonami) — the original MTProto Python library.
- Maintained & developed for [Elys Userbot](https://github.com/ZavozDevs/Elys) by [ZavozDevs](https://github.com/ZavozDevs).
- Licensed under the [MIT License](LICENSE.md).
