rubiko 1.0.3

کتابخانه رسمی روبیکا - ساخت ربات‌های توکنی و سلف

Rubiko - کتابخانه رسمی روبیکا

کتابخانه قدرتمند برای ساخت ربات‌های توکنی - سلف روبیکا

---

نصب

pip install rubiko

---

شروع سریع

from rubiko import RubikaBot bot = RubikaBot("YOUR_BOT_TOKEN") bot.send_message("chat_id", "سلام!") bot.run()

---

متدها

ارسال پیام

send_message(chat_id, text, reply_to=None, parse_mode=None) - ارسال پیام متنی با قابلیت ریپلای send_photo(chat_id, photo_path, caption="") - ارسال عکس send_video(chat_id, video_path, caption="") - ارسال ویدیو send_audio(chat_id, audio_path, caption="") - ارسال صدا send_document(chat_id, file_path, caption="") - ارسال فایل send_sticker(chat_id, sticker_path) - ارسال استیکر send_voice(chat_id, voice_path, caption="") - ارسال ویس send_animation(chat_id, gif_path, caption="") - ارسال گیف send_location(chat_id, lat, lon) - ارسال موقعیت send_contact(chat_id, phone, first_name, last_name="") - ارسال مخاطب send_poll(chat_id, question, options, is_anonymous=True) - ارسال نظرسنجی

مدیریت پیام

edit_message_text(chat_id, msg_id, new_text, parse_mode=None) - ویرایش متن edit_message_caption(chat_id, msg_id, new_caption) - ویرایش کپشن delete_message(chat_id, msg_id) - حذف پیام forward_message(chat_id, from_chat, msg_id) - فوروارد پیام copy_message(chat_id, from_chat, msg_id) - کپی پیام pin_message(chat_id, msg_id) - پین کردن پیام unpin_message(chat_id, msg_id) - آنپین کردن پیام unpin_all_messages(chat_id) - آنپین کردن همه پیام‌ها

دریافت اطلاعات

get_me() - اطلاعات ربات get_chat(chat_id) - اطلاعات چت get_chat_member(chat_id, user_id) - اطلاعات یک عضو get_chat_administrators(chat_id) - لیست ادمین‌ها get_chat_members_count(chat_id) - تعداد اعضا get_updates(offset=None, limit=100) - دریافت پیام‌های جدید get_file(file_id) - اطلاعات فایل download_file(file_id, destination) - دانلود فایل

مدیریت گروه

kick_chat_member(chat_id, user_id, until_date=None) - اخراج عضو (با امکان زمان‌دار) unban_chat_member(chat_id, user_id) - آنبان کردن عضو restrict_chat_member(chat_id, user_id, until_date=None) - محدودیت عضو promote_chat_member(chat_id, user_id) - ترفیع به ادمین set_chat_title(chat_id, title) - تغییر عنوان گروه set_chat_description(chat_id, description) - تغییر توضیحات گروه set_chat_photo(chat_id, photo_path) - تغییر عکس گروه delete_chat_photo(chat_id) - حذف عکس گروه export_chat_invite_link(chat_id) - ساخت لینک دعوت

وب‌هوک

set_webhook(url) - تنظیم وب‌هوک delete_webhook() - حذف وب‌هوک get_webhook_info() - اطلاعات وب‌هوک

اکشن‌ها

send_chat_action(chat_id, action) - ارسال وضعیت (تایپ، آپلود و...) typing(chat_id) - نمایش وضعیت تایپ upload_photo(chat_id) - نمایش وضعیت آپلود عکس upload_video(chat_id) - نمایش وضعیت آپلود ویدیو upload_audio(chat_id) - نمایش وضعیت آپلود صدا upload_document(chat_id) - نمایش وضعیت آپلود فایل

پاسخ به درخواست‌ها

answer_callback_query(callback_id, text, show_alert=False) - پاسخ به دکمه‌های شیشه‌ای answer_inline_query(inline_query_id, results) - پاسخ به درخواست‌های inline

ترجمه

translate_text(text, target_language="fa") - ترجمه متن enable_auto_translate_to_persian() - فعال کردن ترجمه خودکار به فارسی disable_auto_translate() - غیرفعال کردن ترجمه خودکار

پروکسی

bot = RubikaBot("TOKEN", proxy="https://api.rubka.ir") - رفع تحریم

---

کیبوردها

from rubiko import InlineKeyboardMarkup, InlineKeyboardButton, ReplyKeyboardMarkup, ReplyKeyboardRemove

کیبورد شیشه‌ای

keyboard = InlineKeyboardMarkup() keyboard.add( InlineKeyboardButton("دکمه ۱", callback_data="data1"), InlineKeyboardButton("وبسایت", url="https://example.com") ) bot.send_message("chat_id", "متن", reply_markup=keyboard)

کیبورد معمولی

keyboard = ReplyKeyboardMarkup([ ["دکمه ۱", "دکمه ۲"], ["دکمه ۳"] ]) bot.send_message("chat_id", "متن", reply_markup=keyboard)

حذف کیبورد

bot.send_message("chat_id", "متن", reply_markup=ReplyKeyboardRemove())

---

هندلرها

@bot.on("message") def handle_message(msg): bot.send_message(msg.chat.id, f"سلام {msg.from_user.first_name}!")

@bot.on("command_start") def handle_start(msg, args): bot.send_message(msg.chat.id, "به ربات خوش اومدی!")

@bot.on("callback_query") def handle_callback(callback): bot.answer_callback_query(callback.id, "✅ انجام شد!")

---

ParseMode (HTML/Markdown)

from rubiko import ParseMode

bot.send_message("chat_id", "متن پررنگ", parse_mode=ParseMode.HTML) bot.send_message("chat_id", "متن ایتالیک", parse_mode=ParseMode.MARKDOWN)

---

مدیریت خطا

from rubiko import RubikoError

try: bot.send_message("chat_id", "سلام!") except RubikoError as e: print(f"خطا: {e}")

---

سازنده

رادین کریمی

کانال رسمی

@rubiko_official

لینک‌ها

PyPI: https://pypi.org/project/rubiko/ GitHub: https://github.com/rubiko-radinkarimi