Metadata-Version: 2.4
Name: styledbots
Version: 1.0.0
Summary: Modern, clean Telegram Bot library - Better than Telebot. Perfect for Pydroid 3
Author: StyledBots Team
License-Expression: MIT
Project-URL: Homepage, https://github.com/styledbots/styledbots
Project-URL: Documentation, https://github.com/styledbots/styledbots#readme
Project-URL: Bug Tracker, https://github.com/styledbots/styledbots/issues
Keywords: telegram,bot,telebot,styledbots,pydroid,telegram-bot
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Dynamic: license-file

# StyledBots 🚀

**Modern, clean & powerful Telegram Bot library**  
**Better than / equal to Telebot** • Perfect for **Pydroid 3**

---

## Installation

### For everyone (including Pydroid 3):

```bash
pip install styledbots
```

That's it!

---

## Quick Start

```python
from styledbots import Bot, Style, InlineKeyboard

bot = Bot("YOUR_BOT_TOKEN")

@bot.command("start")
def start(message):
    kb = InlineKeyboard()
    kb.button("Click me", "btn1")
    kb.button("Google", url="https://google.com")

    text = f"Hello {Style.bold(message.from_user.first_name)}!"
    bot.reply_to(message, text, reply_markup=kb)

@bot.callback_query_handler(func=lambda c: c.data == "btn1")
def button_handler(call):
    call.answer("You clicked!", show_alert=True)

bot.infinity_polling()
```

---

## Features

- Simple & clean API (Telebot-compatible)
- Beautiful **Style** helpers (bold, italic, spoiler, code, etc.)
- Fluent **Inline & Reply Keyboards**
- Powerful **filters** system
- Middleware support
- Simple storage (Memory + File)
- Lightweight (only `requests`)
- Fully synchronous → works great on Android / Pydroid 3
- Type hints & clean structure

---

## Style Helpers

```python
from styledbots import Style

Style.bold("text")
Style.italic("text")
Style.underline("text")
Style.strike("text")
Style.code("code")
Style.pre("code block", "python")
Style.spoiler("hidden")
Style.link("Click", "https://...")
Style.mention(user_id, "Name")
```

---

## Keyboards

```python
from styledbots import InlineKeyboard, ReplyKeyboard

# Inline
kb = InlineKeyboard()
kb.button("Yes", "yes").button("No", "no")
kb.row()
kb.button("Cancel", "cancel")

# Reply
rkb = ReplyKeyboard()
rkb.row("Option 1", "Option 2")
rkb.row("Back")
```

---

## Why StyledBots?

| Feature              | Telebot     | StyledBots      |
|----------------------|-------------|-----------------|
| Ease of use          | Excellent   | Excellent       |
| Styling helpers      | No          | Yes             |
| Fluent keyboards     | Manual      | Yes             |
| Middleware           | Limited     | Yes             |
| Storage helpers      | No          | Yes             |
| Pydroid 3 ready      | Yes         | Yes             |
| Clean structure      | Medium      | Excellent       |

---

## Links

- PyPI: https://pypi.org/project/styledbots/
- Source: https://github.com/styledbots/styledbots (create your repo)

Made with ❤️ for Pydroid 3 users and Telegram bot developers.
