Eitaa Bot SDK

یک کتابخانه پایتون ساده و قدرتمند برای تعامل با API ربات‌های پیام‌رسان Eitaa.

توضیحات (Description)

این SDK راهی آسان برای ساخت و تعامل با ربات‌های Eitaa با استفاده از پایتون فراهم می‌کند. از عملیات همزمان (synchronous) و ناهمزمان (asynchronous) پشتیبانی می‌کند.

نصب (Installation)

2. نصب بسته با استفاده از pip:

pip install eitaayarbot

🔹 کلاس‌ها و متدها

1. _BaseEitaaBot

کلاس پایه برای هر دو حالت سینک و آسنکرون، شامل توابع کمکی.

2. EitaaBot (سینک / Sync)

3. AsyncEitaaBot (آسنکرون / Async)

توجه: تمام متدهای Async باید با await فراخوانی شوند.

نحوه استفاده (Usage)

نمونه‌ای ساده از نحوه استفاده از SDK:

from eitaayarbot import EitaaBot

# جایگزین کردن "YOUR_BOT_TOKEN" با توکن ربات Eitaa خودتان

BOT_TOKEN = "YOUR_BOT_TOKEN"

# ایجاد یک نمونه از EitaaBot
bot = EitaaBot(token=BOT_TOKEN)

try:
    # دریافت اطلاعات ربات (Get bot info)
    info = bot.get_info()
    print(info) # Bot: {info['username']}

    # ارسال یک پیام (Send a message)
    chat_id = "YOUR_CHAT_ID"  # جایگزین کردن با شناسه چت مورد نظر (Replace with your desired chat ID)
    text = "سلام دنیا! این یه پیام از ربات Eitaa من هست." # Hello world! This is a message from my Eitaa bot.
    bot.send_message(chat_id=chat_id, text=text)
    print("پیام با موفقیت ارسال شد.") # Message sent successfully.

    # ارسال یک فایل (Send a file)
    file_path = "example.txt"  # جایگزین کردن با مسیر فایل مورد نظر (Replace with your desired file path)
    with open(file_path, "w") as f:
        f.write("این یه فایل نمونه است.") # This is a sample file.
    bot.send_file(chat_id=chat_id, file_path=file_path, caption="فایل نمونه") # Sample file
    print("فایل با موفقیت ارسال شد.") # File sent successfully.

except RuntimeError as e:
    print(f"خطا: {e}") # Error: {e}

finally:
    # بستن اتصال (Close the connection)
    bot.close()

import asyncio
from eitaayarbot import AsyncEitaaBot

async def main():
    token = "توکن-ربات-تو"
    bot = AsyncEitaaBot(token)

    info = await bot.get_info()
    print(info)

    await bot.send_message(chat_id=12345, text="سلام دنیا Async!")

    await bot.send_document(chat_id=12345, document_path="path/to/file.pdf", caption="یک سند")

    await bot.close()

asyncio.run(main())