A simple and flexible Python library for building advanced Rubika bots with powerful message handling, inline buttons, and custom filters.
Project description
Python library for rubika API
Rubigram
Rubigram is a powerful asynchronous Python framework for building advanced bots on Rubika, offering features like concurrent message handling, advanced filtering, and support for both webhooks and polling.
Features
- Asynchronous and fast: handle multiple messages concurrently.
- Advanced filters for private chats, commands, and text messages.
- Easy message and media sending (text, images, videos, files).
- Support for both webhooks and polling.
- Interactive keyboards and buttons for better user engagement.
- Flexible integration with databases for storing settings and data.
Start
from rubigram import Client, filters
from rubigram.types import Update
client = Client("bot_token")
@client.on_message(filters.command("start"))
async def start(client: Client, update: Update):
await update.reply("||Hello|| __from__ **Rubigram!**")
client.run()
Button and Keypad
from rubigram import Client, filters
from rubigram.enums import ChatKeypadType
from rubigram.types import Update, Keypad, Button, KeypadRow
client = Client("bot_token")
@client.on_message(filters.photo)
async def start(client: Client, update: Update):
button_1 = Button("send", "send Photo")
button_2 = Button("save", "Save Photo")
row = KeypadRow([button_1, button_2])
keypad = Keypad([row])
await update.reply(
"Select your action:",
chat_keypad=keypad,
chat_keypad_type=ChatKeypadType.NEW
)
client.run()
Use webhook and Get inline button data
from rubigram import Client, Server, filters
from rubigram.types import (
Update,
Button,
Keypad,
KeypadRow,
InlineMessage
)
client = Client(token="bot_token")
server = Server(client, "webhook_url")
@client.on_message(filters.photo)
async def start(client: Client, update: Update):
button_1 = Button("send", "send Photo")
button_2 = Button("save", "Save Photo")
row = KeypadRow([button_1, button_2])
keypad = Keypad([row])
await update.reply("Select your action:", inline_keypad=keypad)
@client.on_inline_message(filters.button(["send", "save"]))
async def inline_message(client: Client, message: InlineMessage):
button_id = message.aux_data.button_id
if button_id == "send":
await message.answer("You clicked the send button")
else:
await message.answer("You clicked the save button")
@client.on_start()
async def start(client):
print("Start bot ....")
@client.on_stop()
async def stop(client):
print("Stop bot")
server.run_server()
Auto state and save tmp data in cache
from rubigram import Client, Storage, filters
from rubigram.types import Update
storage = Storage(ttl=120)
client = Client("bot_token", storage=storage) # You can leave the `storage` parametr empty
@client.on_message(filters.command("start") & filters.private)
async def start(client: Client, update: Update):
state = client.state(update.chat_id)
await state.set("name")
await update.reply("Send your name:")
@client.on_message(filters.state("name") & filters.text & filters.private)
async def save_name(client: Client, update: Update):
state = client.state(update.chat_id)
await state.set("email", name=update.text)
await update.reply("Send your Email:")
@client.on_message(filters.state("email") & filters.text & filters.private)
async def save_email(client: Client, update: Update):
state = client.state(update.chat_id)
data = await state.get()
print(data)
await state.delete()
client.run()
Implementation of multiple programs
from rubigram import Client
import asyncio
tokens = ["TOKEN_1", "TOKEN_2"]
async def main():
for token in tokens:
async with Client(token) as client:
info = await client.get_me()
print(info)
asyncio.run(main())
Rubino
from rubigram.rubino import Rubino
import asyncio
async def main():
async with Rubino(auth="auth_account") as client:
info = await client.get_my_profile_info()
print(info)
asyncio.run(main())
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rubigramclient-1.7.30.tar.gz.
File metadata
- Download URL: rubigramclient-1.7.30.tar.gz
- Upload date:
- Size: 74.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f09c00ece6edc9645fc27f20dd41c5fe7af27ddbe524843c3ece5614f285773d
|
|
| MD5 |
c0e7f64bcb83efcd79c20aacb16ee436
|
|
| BLAKE2b-256 |
73ce8a45094bbc47953c2d3395b626b69f5f9877b88098e14362182395f9ab6e
|
File details
Details for the file rubigramclient-1.7.30-py3-none-any.whl.
File metadata
- Download URL: rubigramclient-1.7.30-py3-none-any.whl
- Upload date:
- Size: 173.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e89bfb456853dbaca98c1d76848d73d3963e8e7a3ff46b9bc211300003fabb62
|
|
| MD5 |
9b33dc54c9a0a4b9e505a33635b3226c
|
|
| BLAKE2b-256 |
5422035d165cd316b0fce994056a129973ed3491988d3d8aba332f29aad55210
|