Skip to content

pyrobale/pyrobale

Repository files navigation

pyrobaletext

Bale Bot API Python Library

A modern, easy-to-use Python wrapper for the Bale Bot API that makes building Bale bots simple and intuitive.

Features

  • 🚀 Simple & Intuitive - Clean, Pythonic API design
  • 📨 Full Message Support - Text, photos, videos, documents, and more
  • ⌨️ Interactive Elements - Inline keyboards, reply keyboards, and buttons
  • 🔄 Real-time Updates - Webhook and polling support
  • 📁 File Handling - Easy upload and download of media files
  • 🛡️ Error Handling - Comprehensive exception handling
  • 📖 Type Hints - Full typing support for better development experience
  • Async Support - asynchronous operations

Installation

pip install pyrobale

Quick Start

from pyrobale.client import Client
from pyrobale.objects import Message, UpdatesTypes

bot = Client("YOUR_BOT_TOKEN")

@bot.on_message()
async def message_handler(message: Message):
    await message.reply("Hello, world!")

bot.run()

Examples

Conversation Bot

from pyrobale.objects import *
from pyrobale.client import Client, Message, UpdatesTypes

client = Client("YOUR_BOT_TOKEN")

async def handle_message(message: Message):
    if message.text == "/start":
        await message.reply("Hi! Im a pyrobale RoBot!")
        await client.wait_for(UpdatesTypes.MESSAGE)
        await message.reply("Okay! wait_for Test Compeleted")

client.add_handler(UpdatesTypes.MESSAGE, handle_message)

client.run()

Echo Bot

from pyrobale.client import Client
from pyrobale.objects import Message, UpdatesTypes

bot = Client("YOUR_BOT_TOKEN")

@bot.on_message()
async def message_handler(message: Message):
    await message.reply(message.text)

bot.run()

Inline Keyboard

from pyrobale.client import Client
from pyrobale.objects import Message, UpdatesTypes, InlineKeyboardButton, InlineKeyboardMarkup, CopyTextButton

bot = Client("YOUR_BOT_TOKEN")
async def message_handler(message: Message):
    buttons = InlineKeyboardMarkup()
    buttons.add_button("URL", url="https://google.com")
    buttons.add_button("Callback", callback_data="callback")
    buttons.add_row()
    buttons.add_button("WebApp", web_app="https://daradege.ir")
    buttons.add_button("Copy", copy_text_button=CopyTextButton("TEXT"))
    await message.reply("Hello, world!", reply_markup=buttons)

Core Abilities

  • Message Handling - Process text, commands, and media messages
  • Callback Queries - Handle inline keyboard interactions
  • File Operations - Send and receive photos, videos, documents
  • Chat Management - Get chat info, member management
  • Custom Keyboards - Create interactive user interfaces
  • Webhook Support - Production-ready webhook handling
  • Middleware Support - Add custom processing layers

Documentation

For detailed documentation and advanced usage, visit our documentation site.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

About

A Python wrapper for the Bale Bot API that makes it easy to build Bale bots.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages