balepy

# نصب آخرین نسخه
pip install -U balepy

# نصب از GitHub
pip install git+https://github.com/mamdmehrabi/balepy.git

from balepy import Client, filters

bot = Client("MyBot", "TOKEN")

@bot.on_message(filters.command("start"))
async def start_handler(message):
    await message.reply("سلام! ربات شروع شد 🌿")

@bot.on_message(filters.text)
async def echo(message):
    await message.reply(message.text)

bot.run()

from balepy import Client, filters
from balepy.types import InlineKeyboardMarkup, InlineKeyboardButton

bot = Client("ButtonBot", "TOKEN")

@bot.on_message(filters.command("menu"))
async def menu(message):
    keyboard = InlineKeyboardMarkup([
        [InlineKeyboardButton("گزینه ۱", callback_data="opt1")],
        [InlineKeyboardButton("گزینه ۲", callback_data="opt2")],
    ])
    await bot.send_message(message.chat_id, "انتخاب کن:", reply_markup=keyboard)

@bot.on_callback_query(filters.callback_data("opt1"))
async def on_opt1(callback):
    await bot.anwser_callback_query(callback.id, text="گزینه اول انتخاب شد!")

bot.run()

# استفاده در داخل event loop
import asyncio

async def main():
    await bot.start()

asyncio.run(main())

# middleware ساده برای لاگ
async def logging_middleware(client, update):
    print(f"Update received: {update}")
    return True  # ادامه پردازش

# middleware برای فیلتر کاربر بلاک شده
async def block_filter(client, update):
    blocked_users = [123456]
    if update.message and update.message.from_user.id in blocked_users:
        return False  # توقف پردازش

bot.use(logging_middleware)
bot.use(block_filter)

await bot.send_message(
    chat_id=123456789,
    text="<b>سلام!</b> این یک پیام تستی است.",
    parse_mode="HTML"
)

await bot.send_photo(
    chat_id=message.chat_id,
    photo="https://example.com/image.jpg",
    caption="عکس زیبا 🌿"
)

await bot.send_video(
    chat_id=message.chat_id,
    video="file_id_here",
    caption="ویدیو",
    width=1280,
    height=720,
    duration=60
)

await bot.send_document(
    chat_id=message.chat_id,
    document="file_id_or_url",
    caption="فایل PDF",
    file_name="document.pdf"
)

from balepy.types import InputMediaPhoto

await bot.send_media_group(
    chat_id=message.chat_id,
    media=[
        InputMediaPhoto("file_id_1", caption="تصویر اول"),
        InputMediaPhoto("file_id_2"),
    ]
)

@bot.on_callback_query()
async def handle_callback(callback):
    await bot.anwser_callback_query(
        callback_query_id=callback.id,
        text="✅ دریافت شد",
        show_alert=True
    )

# دریافت اطلاعات فایل
file_obj = await bot.get_file(message.document.file_id)
url = bot.get_file_url(file_obj.file_path)

# دانلود مستقیم
file_path, download_url = await bot.download_file(file_id)

from balepy.types import BotCommand

await bot.set_my_commands([
    BotCommand("start", "شروع ربات"),
    BotCommand("help", "راهنما"),
    BotCommand("menu", "منوی اصلی"),
])

from balepy import Client
from balepy.types import LabeledPrice

bot = Client("PayBot", "TOKEN", wallet_token="WALLET_TOKEN")

@bot.on_message(filters.command("buy"))
async def buy(message):
    await bot.send_invoice(
        chat_id=message.chat_id,
        title="اشتراک ماهانه",
        description="۳۰ روز دسترسی کامل",
        payload="subscription_monthly",
        prices=[LabeledPrice("اشتراک", 50000)],
        need_phone_number=True
    )

@bot.on_pre_checkout_query
async def checkout(query):
    await bot.answer_pre_checkout_query(query.id, ok=True)

@bot.on_successful_payment
async def payment_done(message):
    await message.reply("✅ پرداخت موفق!")

# AND — پیام متنی در چت خصوصی
@bot.on_message(filters.text & filters.private)
async def private_text(message): ...

# OR — عکس یا ویدیو
@bot.on_message(filters.photo | filters.video)
async def media_handler(message): ...

# NOT — هر پیامی که از ربات نباشد
@bot.on_message(~filters.bot)
async def human_only(message): ...

# ترکیب پیچیده
@bot.on_message(
    (filters.text | filters.caption) &
    filters.group &
    ~filters.bot
)
async def group_text(message): ...

# فیلتر sync
admin_filter = filters.create(lambda msg: msg.from_user.id in [123, 456])

# فیلتر async (با دسترسی به دیتابیس)
async def is_premium(message):
    return await db.is_premium_user(message.from_user.id)

premium_filter = filters.create(is_premium)

@bot.on_message(premium_filter & filters.text)
async def premium_only(message):
    await message.reply("✨ محتوای ویژه کاربران Premium")

from balepy.handlers import CommandHandler, CallbackQueryHandler

async def start_cb(message):
    await message.reply("شروع شد!")

async def btn_cb(callback):
    await bot.anwser_callback_query(callback.id, text="OK")

bot.add_handler(CommandHandler("start", start_cb))
bot.add_handler(CallbackQueryHandler(btn_cb, data_match="btn_*"))

from balepy.types import (
    User, Chat, Message, CallbackQuery,
    InlineKeyboardMarkup, InlineKeyboardButton,
    LabeledPrice, BotCommand, ChatPermissions,
    InputMediaPhoto, InputMediaVideo
)

from balepy.errors import APIError

# روش ۱: try/except در هر هندلر
@bot.on_message(filters.text)
async def handler(message):
    try:
        await bot.send_message(message.chat_id, "سلام")
    except APIError as e:
        print(f"Error {e.error_code}: {e.description}")

# روش ۲: error handler جهانی
@bot.on_error
async def global_error(error, update):
    print(f"Unhandled: {error}")