<a href="https://github.com/mester-root/rubx"> <img src="https://raw.githubusercontent.com/Mester-Root/rubx/main/icons/action-rubx.jpg" alt="Rubx" width="320"> </a> Rubika Client API Framework for Python <a href="https://pypi.org/project/rubx"> Homepage </a> • <a href="https://github.com/Mester-Root/rubx/tree/main/docs"> Documentation </a> • <a href="https://github.com/Mester-Root/rubx/tree/main/Examples"> Examples </a> • <a href="https://github.com/Mester-Root/rubx/tree/main/Tools"> Tools </a>

Rubx | 🔶 | روبیکس :

is so fast

Messenger Methods - مثال پیامرسان:


from rb import RubikaClient # rb: is main package

with RubikaClient('session') as client:
   client.send_message('**Hey** __from__ ``rubx``', '@username')

Or

from rb import RubikaClient as Client

def respond(callable, params) -> dict:
    return callable(**params)

with Client(...) as client:
    print(
        respond(
            client.send_message,
            dict(chat_id=..., text='Hey')
            )
        )

Or

Shorcuts | مثالی از چند میانبر

from rb import RubikaClient

with RubikaClient(...) as client:
    print(client == dict(text='Hey', chat_id='chat-guid')) # to send message
    # print(client * 'chat-guid') # to get chat info
   # use the operators

برای دیدن میانبر های کامل به مستندات ماژول مراجعه کنید.

for: if you forget the method name

from rb import RubikaClient

with RubikaClient('session') as client:
    print(client.getChatInfo(client, 'chat-guid')) # GetChatInfo, GETchatINFO, or ...
    # normally: client.get_chat_info('chat-guid')

Rubino Methods | مثال کلاینت روبینو :


from rb import RubinoClient

with RubinoClient(__name__, 'session') as client:
    client.create_page(...)

Handler Methods | هندلر :

Handler Examples

from rb import Handler, EventBuilder, Filters, Performers

client = Handler(...)

# handlers: HandShake, ChatsUpdates, MessagesUpdates
client.add_event_handling(func=Performers.chats_updates, events=dict(get_chats=True, get_messages=True, pattern=('/start', 'Hey from rubx lib.')))

@client.handler
def hello(app, message: EventBuilder, event):
    # to print message: print(message) or print(event)
    # to use all methods: app.create_objcet_voice_chat(...)
    message.respond(message.pattern, Filters.author) # filters: chat, group, channel, author

Or

from rb import Handler, NewMessage, Filters, EventBuilder, Performers

client = Handler(...)

@client.on(NewMessage(client.handle, handle_name=Performers.chats_updates))
def update(event: EventBuilder):
    ... # event.respond('Hey', Filters.chat)

Or

from rb import Handler, Filters, Performers

client = Handler('session')

def event(message):
    message.respond(message.pattern, Filters.author)
        
client.add_event_handling(func=Performers.chats_updates, event=dict(get_chats=True, get_messages=True, pattern=('/start', 'Hi from rubx lib.')))
client.starting = True
client.command_handler(event)

To using HandShake(WebSocket):

from rb import Handler, EventBuilder, Filters, Performers

client = Handler('abc...', 'u0...')
client.add_event_handling(func=Performers.hand_shake, events=dict(get_messages=True, get_chats=False))
@client.handler
def update(app, update, event):
    if update.message.text == '/start':
        message.reply(text='Hello my dear', chat_id=update.message.author_object_guid, reply_to_message_id=update.message.message_id)
        # or using repond: message.respond('Hey!', Filters.author)

Async Methods:

from rb import Client # Client: asycn reader

async def run(*args):
    async with Client(...) as client:
        result = await client.start(client.send_message, 'Hey! from rubx', 'chat-guid')
        print(result)

Client.run(run)

Bot API Methods:

Example for api methods send message text

from rb import BotAPI

with BotAPI(__name__, 'token') as app:
    app.send_message('chat-id', 'Hey!')

Handler

from rb import BotAPI

with BotAPI(__name__, 'token') as app:
    app.add_event_handling(('\w{1}start', 'Hello'))
    
    @app.handler
    def update(methods, update, event):
        ...

INSTALLING | نصب

pip install --user rubx

UPGRADE | بروز رسانی

pip install rubx --upgrade

Rubx - ⚡

Now the best ‍sync‍ and async library for Rubika's was developed
⭐️ Thanks everyone who has starred the project, it means a lot!

Rubx is an sync Python 3 rubika library to interact with Rubika's API as a user or through a bot account (self API alternative).

🔴 If you have code using Rubx before its 8.0.5 version, you must
read docs to learn how to migrate. 💡

What is this?

🇮🇷 - Rubika is a popular messaging application. This library is meant to make it easy for you to write Python programs that can interact with Rubika. Think of it as a wrapper that has already done the heavy job for you, so you can focus on developing an application. This module provides all the desired methods with a very simple and beautiful user interface and has a very high speed. Give your employer the best experience of a project.