https://virgool.ir/feed/@mohammadlatifiporیه بنده خداییfa2026-11-11 06:54:05https://files.virgool.ir/upload/users/4763344/avatar/dJTFg1.jpghttps://virgool.ir/@mohammadlatifiporhttps://virgool.ir/NotifiedRiopy/کتابخانه-ریوپای-pt2kv7ctoe1qriopyمعرفی و نصبشروع سریعهسته کتابخانهساختار کتابخانهکلاس Botمدل‌های دادهپیشرفتهمدیریت رویدادهااستفاده از Webhookکیبوردهامدیریت خطاهامتفرقهنکات مهممجوز و توسعه‌دهندهنسخه 3.2.0مستندات کتابخانه riopyیک کتابخانه قدرتمند و ساده پایتون برای توسعه ربات‌های روبیکا. این کتابخانه به شما امکان می‌دهد به راحتی با API روبیکا تعامل داشته باشید، پیام‌ها را مدیریت کنید و ربات‌های هوشمند بسازید.نصببرای نصب کتابخانه از pip استفاده کنید:pip install riopyپس از نصب، می‌توانید نسخه نصب شده را بررسی کنید:import riopyprint(riopy.__version__) # 0.1.1 یا بالاترشروع سریعیک بات ساده که به پیام /start پاسخ می‌دهد:import riopybot = riopy.Bot("توکن_بات_شما")@bot.on_message()def handle_message(update): if update.new_message.text == "/start": bot.send_message( chat_id=update.chat_id, text="سلام! به بات من خوش آمدی 👋" )if __name__ == "__main__": bot.polling()ساختار کتابخانهکتابخانه از بخش‌های کلیدی زیر تشکیل شده است:riopy.Bot: کلاس اصلی برای تعامل با APIriopy.types: مدل‌های داده (Update, Message, Chat, ...)riopy.exceptions: استثناهای سفارشی برای مدیریت خطاriopy.polling: مدیریت دریافت پیام‌ها به روش Long Pollingکلاس Botایجاد نمونهfrom riopy import Botbot = Bot("token")متدهای اصلیدریافت اطلاعات باتme = bot.get_me()print(me.bot_title) # نام باتprint(me.bot_id) # شناسه باتارسال پیام متنیmessage_id = bot.send_message( chat_id="شناسه_چت", text="متن پیام", disable_notification=False, # (اختیاری) reply_to_message_id="شناسه_پیام", # (اختیاری) پاسخ به پیام خاص chat_keypad=..., # (اختیاری) کیبورد پایین صفحه inline_keypad=... # (اختیاری) کیبورد شیشه‌ای)ارسال نظرسنجیmessage_id = bot.send_poll( chat_id="شناسه_چت", question="آیا این کتابخانه مفید است؟", options=["بله", "خیر", "نظری ندارم"])مدیریت اعضا (مسدود کردن و رفع مسدودیت)# مسدود کردن کاربر در گروه/کانالbot.ban_chat_member("chat_id", "user_id")# رفع مسدودیت کاربرbot.unban_chat_member("chat_id", "user_id")مدل‌های داده (riopy.types)این بخش شامل ساختار داده‌های دریافتی از سرور است.Updateفیلد نوع توضیحاتtype UpdateTypeEnum نوع آپدیت (NewMessage, UpdatedMessage, ...)chat_id str شناسه چتnew_message Optional[Message] پیام جدیدupdated_message Optional[Message] پیام ویرایش‌شدهMessageفیلد نوع توضیحاتmessage_id str شناسه پیامtext Optional[str] متن پیامsender_id str شناسه فرستندهtime int زمان ارسال (timestamp)مدیریت رویدادها (Polling)کتابخانه به شما امکان می‌دهد با دکوراتور @bot.on_message() تابعی برای پردازش پیام‌های جدید تعریف کنید.@bot.on_message()def my_handler(update): # پردازش پیام جدید passbot.polling(interval=2.0) # بررسی هر ۲ ثانیهاستفاده از Webhookاگر سرور با دامنه عمومی و SSL دارید، می‌توانید به جای Polling از Webhook استفاده کنید.from flask import Flask, requestimport riopyapp = Flask(__name__)bot = riopy.Bot("token")@app.route("/webhook", methods=["POST"])def webhook(): data = request.json update = riopy.types.Update.from_dict(data.get("update")) # پردازش update مشابه قبل return "OK"استفاده از کیبوردهاشما می‌توانید برای تعامل بهتر با کاربر، از دکمه‌های سفارشی استفاده کنید.ارسال کیبورد ساده (Chat Keypad)keypad = { "rows": [ { "buttons": [ {"id": "btn1", "type": "Simple", "button_text": "دکمه ۱"}, {"id": "btn2", "type": "Simple", "button_text": "دکمه ۲"} ] } ], "resize_keyboard": True}bot.send_message( chat_id=chat_id, text="یک دکمه انتخاب کنید:", chat_keypad=keypad, chat_keypad_type=riopy.types.ChatKeypadTypeEnum.New)مدیریت خطاهاکتابخانه استثناهای زیر را تعریف کرده است:riopy.exceptions.RiopyError: خطای پایهriopy.exceptions.APIError: خطای برگشتی از APIriopy.exceptions.InvalidTokenError: توکن نامعتبرfrom riopy.exceptions import APIError, InvalidTokenErrortry: me = bot.get_me()except InvalidTokenError: print("توکن اشتباه است!")except APIError as e: print(f"خطای API: {e}")نکات مهمتوکن: از @BotFather در روبیکا دریافت کنید.دسترسی: برای دیدن همه پیام‌های گروه/کانال، گزینه «دریافت همه پیام‌ها» را در @BotFather فعال کنید.مدیریت: برای استفاده از متدهای مدیریتی مانند ban_chat_member، بات باید در گروه ادمین باشد.مجوز و توسعه‌دهندهاین پروژه تحت مجوز MIT منتشر شده است.توسعه‌دهنده: محمد لطیفی‌پورایمیل: mohammad.latifi@example.comسال انتشار: ۱۴۰۴© ۱۴۰۴ - تمامی حقوق برای کتابخانه riopy محفوظ است.محمد لطیفی پورمحمد لطیفی پورSun, 15 Feb 2026 23:02:34 +0330