Metadata-Version: 2.5
Name: balenova
Version: 0.3.1
Summary: A friendly Python client for Bale accounts
Project-URL: Homepage, https://github.com/iliasync/balenova
Project-URL: Documentation, https://github.com/iliasync/balenova#readme
Project-URL: Repository, https://github.com/iliasync/balenova
Project-URL: Issues, https://github.com/iliasync/balenova/issues
Author: iliasync
License: MIT
License-File: LICENSE
Keywords: asyncio,bale,client,messaging
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: protobuf<8,>=7.35.1
Requires-Dist: websockets<17,>=13
Provides-Extra: dev
Requires-Dist: grpcio-tools<2,>=1.83; extra == 'dev'
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.3; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Requires-Dist: types-protobuf>=6.30; extra == 'dev'
Provides-Extra: voice
Requires-Dist: livekit<2,>=1.1; extra == 'voice'
Description-Content-Type: text/markdown

# BaleNova

راه‌اندازی سادهٔ حساب بله در Python.

[GitHub](https://github.com/iliasync/balenova) · [PyPI](https://pypi.org/project/balenova/) · [گزارش مشکل](https://github.com/iliasync/balenova/issues)

## نصب

Python 3.10 یا جدیدتر لازم است.

```bash
python -m pip install --upgrade balenova
```

برای قابلیت پخش صدا در تماس:

```bash
python -m pip install --upgrade "balenova[voice]"
```

## راه‌اندازی

فایلی به نام `main.py` بسازید:

```python
from balenova import Client, events, filters

app = Client("my_account")


@app.on(events.NewMessage, filters.command("start"))
async def start(event):
    await event.reply("سلام! آماده‌ام 🌱")


app.run_forever()
```

برنامه را اجرا کنید:

```bash
python main.py
```

در اجرای اول، شماره تلفن، کد ورود و در صورت فعال‌بودن رمز دومرحله‌ای پرسیده
می‌شود. ورودهای بعدی از session ذخیره‌شده استفاده می‌کنند.

## نصب از GitHub

```bash
git clone https://github.com/iliasync/balenova.git
cd balenova
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .
python examples/echo.py
```

در Windows، به‌جای دستور فعال‌سازی بالا اجرا کنید:

```powershell
.venv\Scripts\activate
```

## نکتهٔ امنیتی

پوشهٔ `sessions` و اطلاعات ورود را در GitHub، پیام یا فایل عمومی قرار ندهید.
بهتر است ابتدا با یک حساب آزمایشی شروع کنید.

این پروژه رسمی بله نیست و مسئولیت استفاده از حساب بر عهدهٔ کاربر است.

## مجوز

MIT
