shayanheidari01/splusthon

SPlusthon is a Python library for talking to Soroush Plus, an Iranian messaging app, through its API. It is built on top of Telethon, a well known library originally made for Telegram, and has been adapted to work with Soroush Plus's own protocol instead. The library lets a Python program log in and act either as a regular user account or as a bot, sending and receiving messages the same way a person using the app would. The README describes support for the messenger's own TL Schema at layer 182, RSA and AES encryption, data center routing, and a WebSocket based connection, aiming for a fast and stable experience close to the official client. It works with asyncio for asynchronous code, but the README notes it can also be used in a synchronous style. A notable feature is that it does not require an API ID or API Hash to get started, and its API is designed to look similar to Telethon's so that developers already familiar with that library can pick it up quickly. Installation is a simple pip install from PyPI, or installing the latest development version directly from the GitHub repository. A basic example creates a client with a string based session, and a slightly larger example shows listening for new messages and automatically replying to them. Other shown examples include sending a text message to a username, sending a file, and downloading media from a received message, plus reusing a previously saved session string to reconnect without logging in again. The library depends on aiohttp, pyaes, and rsa, with an optional cryptg package that speeds up encryption. Full documentation is hosted on a separate GitHub Pages site. The project is released under the GNU General Public License version 3, and the README includes a note asking users to follow Soroush Plus's own terms of use, stating that responsibility for how the library is used rests with the user.