Metadata-Version: 2.4
Name: pyroblack
Version: 3.0.2
Summary: Pyrogram, but black. Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
Project-URL: Tracker, https://github.com/eyMarv/pyroblack/issues
Project-URL: Community, https://t.me/OpenFileZ
Project-URL: Source, https://github.com/eyMarv/pyroblack
Project-URL: Documentation, https://eyMarv.github.io/pyroblack-docs
Author-email: eyMarv <eyMarv07@gmail.com>
License-Expression: LGPL-3.0-or-later
License-File: COPYING
License-File: COPYING.lesser
License-File: NOTICE
Keywords: pyroblack black telegram chat messenger mtproto api client library python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Communications
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: aiosqlite-black>=0.21.0
Requires-Dist: pyaes==1.6.1
Requires-Dist: pymediainfo-pyroblack<7.0.0,>=6.1.1
Requires-Dist: pysocks==1.7.1
Provides-Extra: dev
Requires-Dist: hatch<=1.7.0; extra == 'dev'
Requires-Dist: keyring<=25.1.0; extra == 'dev'
Requires-Dist: pytest-asyncio<=0.21.1; extra == 'dev'
Requires-Dist: pytest-cov<=4.1.0; extra == 'dev'
Requires-Dist: pytest<=7.4.3; extra == 'dev'
Requires-Dist: twine<=4.0.2; extra == 'dev'
Provides-Extra: docs
Requires-Dist: pygments<=2.17.2; extra == 'docs'
Requires-Dist: sphinx-autobuild<=2021.3.14; extra == 'docs'
Requires-Dist: sphinx-copybutton<=0.5.2; extra == 'docs'
Requires-Dist: sphinx-immaterial>=0.11.0; extra == 'docs'
Requires-Dist: sphinx-llms-txt==0.7.1; extra == 'docs'
Requires-Dist: sphinx<=7.2.6; extra == 'docs'
Provides-Extra: fast
Requires-Dist: tgcrypto-pyroblack>=1.3.0; extra == 'fast'
Requires-Dist: uvloop<=0.22.1,>0.18.0; (sys_platform == 'darwin' or sys_platform == 'linux') and extra == 'fast'
Description-Content-Type: text/markdown

<p align="center">
    <a href="https://github.com/eyMarv/pyroblack">
        <img src="https://eyMarv.github.io/pyroblack-docs/main/_static/pyroblack.png" alt="pyroblack" width="128">
    </a>
    <br>
    <b>Telegram MTProto API Framework for Python</b>
    <br>
    <a href="https://eyMarv.github.io/pyroblack-docs">
        Documentation
    </a>
    •
    <a href="https://github.com/eyMarv/pyroblack/issues">
        Issues
    </a>
    •
    <a href="https://t.me/OpenFileZ">
        Support
    </a>
</p>

## pyroblack

> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots

``` python
from pyrogram import Client, filters

app = Client("my_account")


@app.on_message(filters.private)
async def hello(client, message):
    await message.reply("Hello from pyroblack!")


app.run()
```

**pyroblack** is a modern, elegant and
asynchronous [MTProto API](https://eyMarv.github.io/pyroblack-docs/topics/mtproto-vs-botapi)
framework. It enables you to easily interact with the main Telegram API through a user account (custom client) or a bot
identity (bot API alternative) using Python.

> **v2.8.0+**: Rebuilt on latest PyroTGFork base (Layer 227) for massive speed improvements — 3x faster than previous versions.

### Key Features

- **Ready**: Install pyroblack with pip and start building your applications right away.
- **Easy**: Makes the Telegram API simple and intuitive, while still allowing advanced usages.
- **Elegant**: Low-level details are abstracted and re-presented in a more convenient way.
- **Fast**: Boosted by PyroTGFork's optimized core and [TgCrypto](https://github.com/pyrogram/tgcrypto), a high-performance C cryptography library.
- **Type-hinted**: Types and methods are all type-hinted, enabling excellent editor support.
- **Async**: Fully asynchronous (also usable synchronously if wanted, for convenience).
- **Powerful**: Full access to Telegram's API to execute any official client action and more.
- **Conversations**: Built-in pyromod support — listen, ask, and wait for messages/callbacks.
- **Telethon compat**: Supports loading Telethon session strings via `is_telethon_string=True`.

### Installing

``` bash
pip3 install -U pyroblack
```

### Resources

- Check out the docs at https://eyMarv.github.io/pyroblack-docs to learn more about pyroblack, get started right
  away and discover more in-depth material for building your client applications.
- Join the official group at https://t.me/OpenFileZ and stay tuned for news, updates and announcements.
