styledbots 1.0.0__tar.gz

styledbots-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StyledBots Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

styledbots-1.0.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include examples *.py
+recursive-include styledbots *.py
+global-exclude *.pyc
+global-exclude __pycache__
+global-exclude *.pyo
+global-exclude .git*

styledbots-1.0.0/PKG-INFO

@@ -0,0 +1,144 @@
+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.

styledbots-1.0.0/README.md

@@ -0,0 +1,115 @@
+# 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.

styledbots-1.0.0/examples/basic_bot.py

@@ -0,0 +1,48 @@
+"""
+Basic StyledBots example
+Works perfectly in Pydroid 3
+"""
+
+from styledbots import Bot, Style
+
+# Replace with your token
+TOKEN = "YOUR_BOT_TOKEN_HERE"
+
+bot = Bot(TOKEN)
+
+@bot.command("start")
+def start(message):
+    name = message.from_user.first_name
+    text = Style.bold(f"Hello {name}!") + "\n\nWelcome to StyledBots 🚀"
+    bot.reply_to(message, text)
+
+@bot.command("help")
+def help_cmd(message):
+    bot.reply_to(message, 
+        Style.bold("Available commands:") + "\n"
+        "/start - Start the bot\n"
+        "/help - Show this help\n"
+        "/style - See styling demo"
+    )
+
+@bot.command("style")
+def style_demo(message):
+    text = (
+        f"{Style.bold('Bold text')}\n"
+        f"{Style.italic('Italic text')}\n"
+        f"{Style.underline('Underlined')}\n"
+        f"{Style.strike('Strikethrough')}\n"
+        f"{Style.code('inline code')}\n"
+        f"{Style.spoiler('Hidden spoiler')}\n"
+        f"{Style.link('Click me', 'https://t.me')}\n\n"
+        f"{Style.pre('print(\"Hello StyledBots\")', 'python')}"
+    )
+    bot.reply_to(message, text)
+
+@bot.message_handler(func=lambda m: True)
+def echo(message):
+    bot.reply_to(message, f"You said: {Style.code(message.text)}")
+
+if __name__ == "__main__":
+    print("Starting basic bot...")
+    bot.infinity_polling()

styledbots-1.0.0/examples/full_featured_bot.py

@@ -0,0 +1,87 @@
+"""
+Full featured example showing almost everything
+"""
+
+from styledbots import Bot, Style, InlineKeyboard, filters
+from styledbots.storage import MemoryStorage
+from styledbots.styles.templates import Templates
+
+TOKEN = "YOUR_BOT_TOKEN_HERE"
+bot = Bot(TOKEN)
+storage = MemoryStorage()
+
+# ===== Middleware example =====
+@bot.middleware_handler()
+def log_updates(update):
+    if update.message:
+        user = update.message.from_user
+        print(f"[{user.id}] {user.first_name}: {update.message.text}")
+
+# ===== Commands =====
+@bot.command("start", "help")
+def start(message):
+    kb = InlineKeyboard()
+    kb.button("📊 Stats", "stats")
+    kb.button("💾 Save Data", "save")
+    kb.row()
+    kb.button("✅ Yes / No Demo", "yesno")
+
+    bot.reply_to(
+        message,
+        Templates.welcome(message.from_user.first_name),
+        reply_markup=kb
+    )
+
+@bot.command("stats")
+def stats(message):
+    count = storage.get("message_count", 0)
+    bot.reply_to(message, f"Total messages processed: {Style.code(str(count))}")
+
+# ===== Callbacks =====
+@bot.callback_query_handler(func=lambda c: c.data == "stats")
+def cb_stats(call):
+    count = storage.get("message_count", 0)
+    call.answer(f"Messages: {count}", show_alert=True)
+
+@bot.callback_query_handler(func=lambda c: c.data == "save")
+def cb_save(call):
+    storage.set(f"user_{call.from_user.id}", {
+        "name": call.from_user.first_name,
+        "username": call.from_user.username
+    })
+    call.answer("Data saved!", show_alert=True)
+
+@bot.callback_query_handler(func=lambda c: c.data == "yesno")
+def cb_yesno(call):
+    from styledbots.keyboards.builder import KeyboardBuilder
+    kb = KeyboardBuilder.yes_no("answer_yes", "answer_no")
+    bot.edit_message_text(
+        "Do you like StyledBots?",
+        chat_id=call.message.chat.id,
+        message_id=call.message.message_id,
+        reply_markup=kb
+    )
+    call.answer()
+
+@bot.callback_query_handler(func=lambda c: c.data in ("answer_yes", "answer_no"))
+def cb_answer(call):
+    if call.data == "answer_yes":
+        text = Templates.success("Awesome! Glad you like it ❤️")
+    else:
+        text = Templates.info("Feedback", "Thanks for your honesty!")
+    bot.edit_message_text(
+        text,
+        chat_id=call.message.chat.id,
+        message_id=call.message.message_id
+    )
+    call.answer()
+
+# ===== Catch-all =====
+@bot.message_handler(func=lambda m: True)
+def counter(message):
+    count = storage.get("message_count", 0) + 1
+    storage.set("message_count", count)
+
+if __name__ == "__main__":
+    print("Starting full featured bot...")
+    bot.infinity_polling()

styledbots-1.0.0/examples/styled_bot.py

@@ -0,0 +1,79 @@
+"""
+Full featured StyledBots example with keyboards + styles
+"""
+
+from styledbots import Bot, Style, InlineKeyboard, ReplyKeyboard, filters
+from styledbots.styles.templates import Templates
+
+TOKEN = "YOUR_BOT_TOKEN_HERE"
+bot = Bot(TOKEN)
+
+@bot.command("start")
+def start(message):
+    kb = InlineKeyboard()
+    kb.button("🎨 Styles Demo", "styles")
+    kb.button("⌨️ Keyboards", "keyboards")
+    kb.row()
+    kb.button("ℹ️ About", "about")
+    kb.button("🔗 Source", url="https://github.com")
+
+    text = Templates.welcome(message.from_user.first_name)
+    bot.send_message(message.chat.id, text, reply_markup=kb)
+
+@bot.callback_query_handler(func=lambda c: c.data == "styles")
+def styles_callback(call):
+    text = (
+        f"{Style.bold('🎨 Style Showcase')}\n\n"
+        f"{Style.bold('Bold')} | {Style.italic('Italic')} | {Style.underline('Underline')}\n"
+        f"{Style.strike('Strike')} | {Style.code('code')} | {Style.spoiler('spoiler')}\n\n"
+        f"{Style.pre('def hello():\\n    print(\"StyledBots\")', 'python')}"
+    )
+    bot.edit_message_text(
+        text,
+        chat_id=call.message.chat.id,
+        message_id=call.message.message_id
+    )
+    call.answer()
+
+@bot.callback_query_handler(func=lambda c: c.data == "keyboards")
+def keyboards_callback(call):
+    kb = ReplyKeyboard()
+    kb.row("Option 1", "Option 2")
+    kb.row("Option 3")
+    kb.row("🔙 Back")
+
+    bot.send_message(
+        call.message.chat.id,
+        "Here's a Reply Keyboard:",
+        reply_markup=kb
+    )
+    call.answer("Keyboard sent!")
+
+@bot.callback_query_handler(func=lambda c: c.data == "about")
+def about_callback(call):
+    text = (
+        f"{Style.bold('StyledBots v1.0')}\n\n"
+        f"Modern Telegram Bot library\n"
+        f"Better than Telebot • Perfect for Pydroid 3\n\n"
+        f"Features:\n"
+        f"• Beautiful styling helpers\n"
+        f"• Fluent keyboards\n"
+        f"• Clean filters\n"
+        f"• Middleware support\n"
+        f"• Lightweight (only requests)"
+    )
+    call.answer()
+    bot.send_message(call.message.chat.id, text)
+
+@bot.message_handler(func=lambda m: m.text == "🔙 Back")
+def back_handler(message):
+    from styledbots.keyboards.reply import ReplyKeyboardRemove
+    bot.send_message(
+        message.chat.id,
+        "Keyboard removed.",
+        reply_markup=ReplyKeyboardRemove()
+    )
+
+if __name__ == "__main__":
+    print("Starting styled bot...")
+    bot.infinity_polling()

styledbots-1.0.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "styledbots"
+version = "1.0.0"
+description = "Modern, clean Telegram Bot library - Better than Telebot. Perfect for Pydroid 3"
+readme = "README.md"
+requires-python = ">=3.7"
+license = "MIT"
+authors = [
+    {name = "StyledBots Team"}
+]
+keywords = ["telegram", "bot", "telebot", "styledbots", "pydroid", "telegram-bot"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/styledbots/styledbots"
+Documentation = "https://github.com/styledbots/styledbots#readme"
+"Bug Tracker" = "https://github.com/styledbots/styledbots/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["styledbots*"]

styledbots-1.0.0/requirements.txt

@@ -0,0 +1 @@
+requests>=2.28.0

styledbots-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

styledbots-1.0.0/setup.py

@@ -0,0 +1,6 @@
+from setuptools import setup
+
+# Modern packaging is handled by pyproject.toml
+# This file is kept for compatibility with older tools
+
+setup()

styledbots-1.0.0/styledbots/__init__.py

@@ -0,0 +1,38 @@
+"""
+StyledBots - Modern, clean & powerful Telegram Bot library
+Better than / equal to Telebot • Perfect for Pydroid 3
+"""
+
+from .core.bot import Bot
+from .core.exceptions import (
+    StyledBotsError,
+    TelegramAPIError,
+    NetworkError,
+    InvalidTokenError,
+)
+from .core.types import Message, User, Chat, CallbackQuery, Update
+from .styles.style import Style
+from .keyboards.inline import InlineKeyboard
+from .keyboards.reply import ReplyKeyboard
+from .keyboards.builder import KeyboardBuilder
+from .filters.filters import filters
+from .version import __version__
+
+__all__ = [
+    "Bot",
+    "Style",
+    "InlineKeyboard",
+    "ReplyKeyboard",
+    "KeyboardBuilder",
+    "filters",
+    "Message",
+    "User",
+    "Chat",
+    "CallbackQuery",
+    "Update",
+    "StyledBotsError",
+    "TelegramAPIError",
+    "NetworkError",
+    "InvalidTokenError",
+    "__version__",
+]

styledbots-1.0.0/styledbots/core/__init__.py

@@ -0,0 +1,4 @@
+from .bot import Bot
+from .api import TelegramAPI
+from .exceptions import *
+from .types import *