nicebot 0.1.0__tar.gz

nicebot-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.env
+*.db
+*.db-*
+.pytest_cache/
+.mypy_cache/
+.coverage

nicebot-0.1.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.1.0 — 2026-11-03
+
+Birinchi chiqarilish.
+
+- Telegram Bot API 10.3: 403 ta tur va 185 ta metod (msgspec)
+- Ichki ORM: SQLite, PostgreSQL, MySQL/MariaDB, MongoDB va avto-migratsiya
+- `ctx.ask`, `confirm`, `choose`, `form` va validatorlar
+- `Button(on_click=)`, callback shablonlari, Toggle, `ttl`/`once`/`only`, Menu, paginate
+- Referal, broadcast, statistika, admin panel, majburiy obuna, support, Telegram Stars
+- Guruh moderatsiyasi va captcha
+- Mini App server: `@bot.api`, initData tekshiruvi, `nicebot.js`
+- Scheduler, fon vazifalari, kesh, i18n (uz/ru/en), DI, middleware
+- Hot reload, `bot.test()`, `nicebot` CLI

nicebot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ozodbek Sobirjonovich
+
+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.

nicebot-0.1.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.5
+Name: nicebot
+Version: 0.1.0
+Summary: Telegram botlar uchun eng qulay Python kutubxonasi: kam kod, ichki ORM, tugmalar, suhbatlar, Mini App — hammasi bitta importda.
+Project-URL: Homepage, https://ozodmeofficial.github.io/nicebot/
+Project-URL: Documentation, https://ozodmeofficial.github.io/nicebot/
+Project-URL: Repository, https://github.com/ozodmeofficial/nicebot
+Project-URL: Issues, https://github.com/ozodmeofficial/nicebot/issues
+Project-URL: Changelog, https://github.com/ozodmeofficial/nicebot/blob/main/CHANGELOG.md
+Author: Ozodbek Sobirjonovich
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aiogram-alternative,async,bot,bot-api,mini-app,orm,telegram,telegram-bot,uzbek
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Russian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: aiosqlite>=0.19
+Requires-Dist: msgspec>=0.18
+Provides-Extra: all
+Requires-Dist: aiomysql>=0.2; extra == 'all'
+Requires-Dist: asyncpg>=0.29; extra == 'all'
+Requires-Dist: motor>=3.3; extra == 'all'
+Requires-Dist: redis>=5.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mongomock-motor>=0.0.29; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: typing-extensions>=4; extra == 'dev'
+Provides-Extra: mongo
+Requires-Dist: motor>=3.3; extra == 'mongo'
+Provides-Extra: mysql
+Requires-Dist: aiomysql>=0.2; extra == 'mysql'
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.29; extra == 'postgres'
+Provides-Extra: redis
+Requires-Dist: redis>=5.0; extra == 'redis'
+Description-Content-Type: text/markdown
+
+# nicebot
+
+**Telegram botlar uchun Python kutubxonasi: kam kod, hamma narsa ichida.**
+
+[![PyPI](https://img.shields.io/pypi/v/nicebot.svg)](https://pypi.org/project/nicebot/)
+[![Python](https://img.shields.io/pypi/pyversions/nicebot.svg)](https://pypi.org/project/nicebot/)
+[![Bot API](https://img.shields.io/badge/Bot%20API-10.3-c4613c.svg)](https://core.telegram.org/bots/api)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+🇺🇿 O'zbekcha · 🇷🇺 [Документация на русском](https://ozodmeofficial.github.io/nicebot/) · 🇬🇧 [English docs](https://ozodmeofficial.github.io/nicebot/)
+
+```python
+from nicebot import Nicebot
+
+bot = Nicebot(token="123456:ABC...")
+
+@bot.command("start")
+async def start(ctx):
+    name = await ctx.ask("Ismingiz?")
+    age = await ctx.ask("Yoshingiz?", int)
+    await ctx.reply(f"Salom, {name}! Siz {age} yoshdasiz.")
+
+bot.start()
+```
+
+Bu kodda `Dispatcher`, `StatesGroup` va FSM yo'q. `ctx.ask()` savol berib, javobni o'sha joyda kutadi. Son kiritilmasa, o'zi qayta so'raydi. Foydalanuvchi esa bazaga avtomatik saqlanadi.
+
+## O'rnatish
+
+```bash
+pip install nicebot                # SQLite bilan
+pip install "nicebot[postgres]"    # + PostgreSQL
+pip install "nicebot[mysql]"       # + MySQL / MariaDB
+pip install "nicebot[mongo]"       # + MongoDB
+pip install "nicebot[all]"         # hammasi + Redis
+```
+
+Tayyor loyiha yaratish:
+
+```bash
+nicebot new mybot && cd mybot && python bot.py
+```
+
+## Ichida nimalar bor
+
+| | |
+|---|---|
+| **Bot API 10.3 to'liq** | 403 ta tur va 185 ta metod rasmiy spetsifikatsiyadan generatsiya qilingan, msgspec asosida |
+| **Ichki ORM** | SQLite, PostgreSQL, MySQL va MongoDB uchun bitta API, avto-migratsiya bilan |
+| **Suhbatlar** | `ask`, `confirm`, `choose(multiple=True)`, `form` va validatorlar (telefon +998, email, sana…) |
+| **Tugmalar** | `Button(on_click=func)`, `"buy:{id:int}"` shablonlari, Toggle, `ttl`, `once`, `only`, avto-joylashuv |
+| **UI** | Ko'p darajali `Menu`, `ctx.paginate()`, reply klaviatura qisqartmalari |
+| **Biznes** | Referal, broadcast (davom ettirish bilan), statistika, admin panel, majburiy obuna, support, Telegram Stars |
+| **Guruhlar** | `ban`, `mute`, `warn`, captcha |
+| **Mini App** | `@bot.api` endpointlari, initData HMAC tekshiruvi, `nicebot.js` |
+| **Arxitektura** | DI (type hint orqali), middleware, Router, `from_env()`, scheduler, fon vazifalari, kesh |
+| **Ishonchlilik** | Flood-wait, retry, file_id keshi, to'g'ri to'xtash, xatolar haqida adminlarga hisobot |
+| **Ishlab chiqish** | `reload=True`, `bot.test()` (Telegram'siz testlar), CLI |
+
+To'liq ro'yxat va qo'llanma: **[hujjatlar sayti](https://ozodmeofficial.github.io/nicebot/)** (uz / ru / en).
+
+## Yana misollar
+
+```python
+from nicebot import Nicebot, Button, Model, fields, Phone
+
+bot = Nicebot(token="...", db="sqlite:///shop.db", admins=[123456789])
+
+class Order(Model):
+    user_id = fields.BigInt(index=True)
+    product = fields.Str(100)
+    phone = fields.Str(20)
+
+async def buy(ctx, product: str):
+    phone = await ctx.ask("Telefon raqamingiz?", Phone)
+    if await ctx.confirm(f"{product} buyurtma qilinsinmi?"):
+        await Order.create(user_id=ctx.user_id, product=product, phone=phone)
+        await ctx.reply("✅ Qabul qilindi!")
+        await ctx.notify_admins(f"🛒 Yangi buyurtma: {product}, {phone}")
+
+@bot.command("shop", description="Do'kon")
+async def shop(ctx):
+    await ctx.reply("Mahsulotni tanlang:", buttons=[
+        Button("📚 Kitob", on_click=buy, product="Kitob"),
+        Button("🎧 Quloqchin", on_click=buy, product="Quloqchin"),
+    ])
+
+bot.start(reload=True)
+```
+
+Adminlar uchun `/stats`, `/broadcast`, `/maintenance` va `/backup` buyruqlari avtomatik ishlaydi.
+
+## Testlash
+
+```python
+async def test_shop():
+    async with bot.test() as t:
+        user = t.user(first_name="Ali")
+        await user.send("/shop")
+        await user.click("Kitob")
+        await user.send("90 123 45 67")
+        await user.click("Ha")
+        assert t.last_in(user.chat_id).text == "✅ Qabul qilindi!"
+```
+
+## Litsenziya
+
+MIT © Ozodbek Sobirjonovich

nicebot-0.1.0/README.md

@@ -0,0 +1,108 @@
+# nicebot
+
+**Telegram botlar uchun Python kutubxonasi: kam kod, hamma narsa ichida.**
+
+[![PyPI](https://img.shields.io/pypi/v/nicebot.svg)](https://pypi.org/project/nicebot/)
+[![Python](https://img.shields.io/pypi/pyversions/nicebot.svg)](https://pypi.org/project/nicebot/)
+[![Bot API](https://img.shields.io/badge/Bot%20API-10.3-c4613c.svg)](https://core.telegram.org/bots/api)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+🇺🇿 O'zbekcha · 🇷🇺 [Документация на русском](https://ozodmeofficial.github.io/nicebot/) · 🇬🇧 [English docs](https://ozodmeofficial.github.io/nicebot/)
+
+```python
+from nicebot import Nicebot
+
+bot = Nicebot(token="123456:ABC...")
+
+@bot.command("start")
+async def start(ctx):
+    name = await ctx.ask("Ismingiz?")
+    age = await ctx.ask("Yoshingiz?", int)
+    await ctx.reply(f"Salom, {name}! Siz {age} yoshdasiz.")
+
+bot.start()
+```
+
+Bu kodda `Dispatcher`, `StatesGroup` va FSM yo'q. `ctx.ask()` savol berib, javobni o'sha joyda kutadi. Son kiritilmasa, o'zi qayta so'raydi. Foydalanuvchi esa bazaga avtomatik saqlanadi.
+
+## O'rnatish
+
+```bash
+pip install nicebot                # SQLite bilan
+pip install "nicebot[postgres]"    # + PostgreSQL
+pip install "nicebot[mysql]"       # + MySQL / MariaDB
+pip install "nicebot[mongo]"       # + MongoDB
+pip install "nicebot[all]"         # hammasi + Redis
+```
+
+Tayyor loyiha yaratish:
+
+```bash
+nicebot new mybot && cd mybot && python bot.py
+```
+
+## Ichida nimalar bor
+
+| | |
+|---|---|
+| **Bot API 10.3 to'liq** | 403 ta tur va 185 ta metod rasmiy spetsifikatsiyadan generatsiya qilingan, msgspec asosida |
+| **Ichki ORM** | SQLite, PostgreSQL, MySQL va MongoDB uchun bitta API, avto-migratsiya bilan |
+| **Suhbatlar** | `ask`, `confirm`, `choose(multiple=True)`, `form` va validatorlar (telefon +998, email, sana…) |
+| **Tugmalar** | `Button(on_click=func)`, `"buy:{id:int}"` shablonlari, Toggle, `ttl`, `once`, `only`, avto-joylashuv |
+| **UI** | Ko'p darajali `Menu`, `ctx.paginate()`, reply klaviatura qisqartmalari |
+| **Biznes** | Referal, broadcast (davom ettirish bilan), statistika, admin panel, majburiy obuna, support, Telegram Stars |
+| **Guruhlar** | `ban`, `mute`, `warn`, captcha |
+| **Mini App** | `@bot.api` endpointlari, initData HMAC tekshiruvi, `nicebot.js` |
+| **Arxitektura** | DI (type hint orqali), middleware, Router, `from_env()`, scheduler, fon vazifalari, kesh |
+| **Ishonchlilik** | Flood-wait, retry, file_id keshi, to'g'ri to'xtash, xatolar haqida adminlarga hisobot |
+| **Ishlab chiqish** | `reload=True`, `bot.test()` (Telegram'siz testlar), CLI |
+
+To'liq ro'yxat va qo'llanma: **[hujjatlar sayti](https://ozodmeofficial.github.io/nicebot/)** (uz / ru / en).
+
+## Yana misollar
+
+```python
+from nicebot import Nicebot, Button, Model, fields, Phone
+
+bot = Nicebot(token="...", db="sqlite:///shop.db", admins=[123456789])
+
+class Order(Model):
+    user_id = fields.BigInt(index=True)
+    product = fields.Str(100)
+    phone = fields.Str(20)
+
+async def buy(ctx, product: str):
+    phone = await ctx.ask("Telefon raqamingiz?", Phone)
+    if await ctx.confirm(f"{product} buyurtma qilinsinmi?"):
+        await Order.create(user_id=ctx.user_id, product=product, phone=phone)
+        await ctx.reply("✅ Qabul qilindi!")
+        await ctx.notify_admins(f"🛒 Yangi buyurtma: {product}, {phone}")
+
+@bot.command("shop", description="Do'kon")
+async def shop(ctx):
+    await ctx.reply("Mahsulotni tanlang:", buttons=[
+        Button("📚 Kitob", on_click=buy, product="Kitob"),
+        Button("🎧 Quloqchin", on_click=buy, product="Quloqchin"),
+    ])
+
+bot.start(reload=True)
+```
+
+Adminlar uchun `/stats`, `/broadcast`, `/maintenance` va `/backup` buyruqlari avtomatik ishlaydi.
+
+## Testlash
+
+```python
+async def test_shop():
+    async with bot.test() as t:
+        user = t.user(first_name="Ali")
+        await user.send("/shop")
+        await user.click("Kitob")
+        await user.send("90 123 45 67")
+        await user.click("Ha")
+        assert t.last_in(user.chat_id).text == "✅ Qabul qilindi!"
+```
+
+## Litsenziya
+
+MIT © Ozodbek Sobirjonovich

nicebot-0.1.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "nicebot"
+dynamic = ["version"]
+description = "Telegram botlar uchun eng qulay Python kutubxonasi: kam kod, ichki ORM, tugmalar, suhbatlar, Mini App — hammasi bitta importda."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Ozodbek Sobirjonovich" }]
+keywords = ["telegram", "bot", "telegram-bot", "bot-api", "async", "orm", "mini-app", "aiogram-alternative", "uzbek"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "Natural Language :: Russian",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "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 :: Application Frameworks",
+    "Typing :: Typed",
+]
+dependencies = [
+    "aiohttp>=3.9",
+    "msgspec>=0.18",
+    "aiosqlite>=0.19",
+]
+
+[project.optional-dependencies]
+postgres = ["asyncpg>=0.29"]
+mysql = ["aiomysql>=0.2"]
+mongo = ["motor>=3.3"]
+redis = ["redis>=5.0"]
+all = ["asyncpg>=0.29", "aiomysql>=0.2", "motor>=3.3", "redis>=5.0"]
+dev = ["pytest>=8", "pytest-asyncio>=0.23", "mongomock-motor>=0.0.29", "typing-extensions>=4"]  # mongomock-motor imports it without declaring it (seen on 3.13)
+
+[project.scripts]
+nicebot = "nicebot.cli:main"
+
+[project.urls]
+Homepage = "https://ozodmeofficial.github.io/nicebot/"
+Documentation = "https://ozodmeofficial.github.io/nicebot/"
+Repository = "https://github.com/ozodmeofficial/nicebot"
+Issues = "https://github.com/ozodmeofficial/nicebot/issues"
+Changelog = "https://github.com/ozodmeofficial/nicebot/blob/main/CHANGELOG.md"
+
+[tool.hatch.version]
+path = "src/nicebot/__about__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nicebot"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/nicebot", "tests", "README.md", "LICENSE", "CHANGELOG.md", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+testpaths = ["tests"]
+pythonpath = ["src"]

nicebot-0.1.0/src/nicebot/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

nicebot-0.1.0/src/nicebot/__init__.py

@@ -0,0 +1,60 @@
+"""nicebot — Telegram botlar uchun eng qulay Python kutubxonasi.
+
+    from nicebot import Nicebot
+
+    bot = Nicebot(token="...")
+
+    @bot.command("start")
+    async def start(ctx):
+        name = await ctx.ask("Ismingiz?")
+        await ctx.reply(f"Salom, {name}!")
+
+    bot.start()
+"""
+from . import types
+from .__about__ import __version__
+from ._base import InputFile
+from .bot import Nicebot
+from .config import Config, load_env
+from .context import Context, FormResult
+from .errors import (
+    AskTimeout,
+    BadRequest,
+    Cancelled,
+    DoesNotExist,
+    Forbidden,
+    IntegrityError,
+    NicebotError,
+    RetryAfter,
+    SkipHandler,
+    StopHandling,
+    TelegramError,
+    ValidationError,
+)
+from .filters import F, Filter
+from .i18n import I18n
+from .keyboards import Button, ReplyButton, Toggle
+from .menu import Menu
+from .orm import Database, Model, Q, fields
+from .orm import F as Col
+from .orm.builtin import User
+from .router import Router
+from .server import WebAppRequest, validate_init_data
+from .storage import DBStorage, MemoryStorage, RedisStorage, Storage
+from .types import API_VERSION
+from .utils import bold, cache, code, escape, html, italic, link, mention, parse_duration, pre, quote, spoiler, strike, underline
+from .validators import Choice, Date, Email, File, Location, Phone, Photo, Regex, Text, Url
+from .validators import Float as Number
+from .validators import Int as Integer
+
+__all__ = [
+    "Nicebot", "Router", "Context", "F", "Filter", "Button", "ReplyButton", "Toggle", "Menu",
+    "Model", "fields", "Database", "Q", "Col", "User",
+    "Phone", "Email", "Date", "Choice", "Regex", "Photo", "File", "Location", "Url", "Text", "Integer", "Number",
+    "html", "escape", "bold", "italic", "underline", "strike", "spoiler", "code", "pre", "link", "mention", "quote", "cache", "parse_duration",
+    "InputFile", "Config", "load_env", "I18n", "FormResult", "WebAppRequest", "validate_init_data",
+    "Storage", "MemoryStorage", "RedisStorage", "DBStorage",
+    "NicebotError", "TelegramError", "BadRequest", "Forbidden", "RetryAfter", "Cancelled", "AskTimeout", "ValidationError",
+    "SkipHandler", "StopHandling", "DoesNotExist", "IntegrityError",
+    "types", "API_VERSION", "__version__",
+]

nicebot-0.1.0/src/nicebot/_base.py

@@ -0,0 +1,75 @@
+"""Base classes shared by generated types."""
+from __future__ import annotations
+
+import io
+import mimetypes
+import os
+from pathlib import Path
+from typing import Any
+
+import msgspec
+
+
+class TelegramObject(msgspec.Struct, kw_only=True, omit_defaults=True, dict=True):
+    """Base of every Telegram type. Fast (msgspec), typed, and convertible to dict."""
+
+    def to_dict(self) -> dict[str, Any]:
+        return msgspec.to_builtins(self)
+
+    def __getitem__(self, item: str) -> Any:  # dict-like access for convenience
+        return getattr(self, item)
+
+
+class InputFile:
+    """A file to upload: local path, bytes, file-like object or URL.
+
+    >>> InputFile("photo.jpg")
+    >>> InputFile(b"...", filename="report.pdf")
+    >>> InputFile.from_url("https://example.com/a.png")   # Telegram downloads it
+    """
+
+    __slots__ = ("data", "filename", "url", "path")
+
+    def __init__(self, data: str | os.PathLike | bytes | io.IOBase, filename: str | None = None):
+        self.url: str | None = None
+        self.path: Path | None = None
+        if isinstance(data, (str, os.PathLike)):
+            self.path = Path(data)
+            self.data = None
+            self.filename = filename or self.path.name
+        elif isinstance(data, (bytes, bytearray)):
+            self.data = bytes(data)
+            self.filename = filename or "file"
+        else:
+            self.data = data.read()
+            self.filename = filename or Path(getattr(data, "name", "file")).name
+
+    @classmethod
+    def from_url(cls, url: str) -> "InputFile":
+        obj = cls.__new__(cls)
+        obj.url, obj.data, obj.path, obj.filename = url, None, None, url.rsplit("/", 1)[-1]
+        return obj
+
+    def read(self) -> bytes:
+        if self.data is not None:
+            return self.data
+        assert self.path is not None
+        return self.path.read_bytes()
+
+    @property
+    def mime(self) -> str:
+        return mimetypes.guess_type(self.filename)[0] or "application/octet-stream"
+
+    @property
+    def cache_key(self) -> str | None:
+        """Stable key used by the file_id cache (local paths only)."""
+        if self.path is None:
+            return None
+        try:
+            st = self.path.stat()
+        except OSError:
+            return None
+        return f"{self.path.resolve()}:{st.st_size}:{int(st.st_mtime)}"
+
+    def __repr__(self) -> str:
+        return f"InputFile({self.filename!r})"