Metadata-Version: 2.4
Name: saad-bot
Version: 0.1.0
Summary: A small Arabic-friendly Telegram Bot API client
Author: SAAD
License: MIT
Project-URL: Homepage, https://pypi.org/project/saad-bot/
Keywords: saad,telegram,bot,api
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# saad-bot

مكتبة Python بسيطة باسم **SAAD_BOT** لإرسال رسائل Telegram بواجهة عربية أو مختصرة، وتعمل على Pydroid 3 وTermux دون اعتماديات خارجية.

## التثبيت

```bash
python -m pip install saad-bot
```

## الاستخدام الآمن

لا تضع التوكن الحقيقي داخل ملف تنشره أو ترسله للآخرين. استخدم متغيرات البيئة:

```python
import os
import saad_bot

saad_bot.configure(
    token=os.environ["SAAD_BOT_TOKEN"],
    user_id=os.environ["SAAD_BOT_USER_ID"],
)

result = saad_bot.أرسل("السلام عليكم")
print(result["ok"])
```

أو استخدم الصيغة المختصرة المتوافقة مع الفكرة الأصلية:

```python
import saad_bot

saad_bot.T = "ضع_التوكن_محليًا_فقط"
saad_bot.USER = "123456789"
saad_bot.s("السلام عليكم")
```

والأسماء المفضلة والأوضح هي:

```python
saad_bot.TOKEN = "..."
saad_bot.USER_ID = "..."
saad_bot.send_message("السلام عليكم")
```

## ملاحظات

تستخدم المكتبة واجهة Telegram Bot API الرسمية عبر HTTPS، وتعيد كائن JSON الناتج من Telegram. إذا رفض Telegram الطلب، تُرفع `TelegramError`. لا تستخدم توكنًا سبق نشره؛ ألغِه من BotFather وأنشئ توكنًا جديدًا.
