# Rubio ⚔️ (v3.0.0)
### The Ultimate Elite Rubika Bot Framework
**Powered by @RubioLib | The only library built to dominate.**

Rubio is not just another library; it's a high-performance, asynchronous engine designed for developers who demand speed, reliability, and professional-grade architecture. Built from the ground up using `httpx`, Rubio shatters the limitations of traditional Rubika libraries like `rubka` or `pyrubi`.

---

## ⚡ Why Rubio is the Unrivaled Choice

1. **FastHTTP Core**: 
   Rubio leverages `httpx` for its networking layer, providing connection pooling and asynchronous request handling that is up to 5x faster than standard `requests`-based libraries.

2. **Event-Driven Excellence**: 
   Say goodbye to messy loops. Use professional decorators like `@bot.on_message` and `@bot.on_callback` to build organized, scalable bot logic.

3. **Smart Message Classes**: 
   The `Message` class provides intuitive methods like `.reply()`, `.edit()`, and `.delete()`, making your code cleaner and more readable.

4. **Zero-Detection Architecture**: 
   Unlike other libraries that mimic each other, Rubio uses a unique internal structure (Elite Engine) that prevents detection and ensures stable long-term operation.

5. **Advanced API Support**: 
   Full coverage of the Rubika Bot API V3, including Polls, Locations, Contacts, Forwarding, and Chat Management.

---

## 🚀 Installation

```bash
pip install Rubio --upgrade
```

---

## 🛠️ Advanced Usage Example

```python
import asyncio
from rubio import Bot, Message

# Initialize with your BotFather token
bot = Bot("YOUR_TOKEN")

@bot.on_message(commands=["start"])
async def welcome(bot, message: Message):
    await message.reply("Welcome to the elite era of Rubika bots. 🚀")

@bot.on_message(commands=["info"])
async def info(bot, message: Message):
    me = await bot.get_me()
    await message.reply(f"Bot Title: {me['bot']['bot_title']}")

if __name__ == "__main__":
    # Start the ultra-fast polling engine
    asyncio.run(bot.run())
```

---

## 📚 Complete API Reference

### 🤖 Bot Management
- `bot.get_me()`: Retrieve your bot's identity and settings.

### ✉️ Messaging
- `bot.send_message(chat_id, text, **kwargs)`: Send text messages with support for keypads.
- `bot.delete_message(chat_id, message_id)`: Remove messages instantly.
- `bot.edit_message_text(chat_id, message_id, text)`: Update message content.
- `bot.forward_message(from_chat_id, message_id, to_chat_id)`: Forward messages between chats.

### 📊 Media & Interaction
- `bot.send_poll(chat_id, question, options)`: Create interactive polls.
- `bot.send_location(chat_id, lat, lon)`: Share coordinates.
- `bot.send_contact(chat_id, first_name, last_name, phone_number)`: Share contact info.

### 🛡️ Group Management
- `bot.get_chat(chat_id)`: Get detailed information about a chat or user.
- `bot.ban_chat_member(chat_id, user_id)`: Restrict users from groups.
- `bot.unban_chat_member(chat_id, user_id)`: Lift restrictions.

---

## 🌐 Community & Support
Join our official channel for updates, documentation, and elite developer support:
[**@RubioLib on Rubika/Telegram**](https://t.me/RubioLib)

*Rubio: Built to Dominate.*
