nicebot

Telegram botlar uchun Python kutubxonasi: kam kod, hamma narsa ichida.

🇺🇿 O'zbekcha · 🇷🇺 Документация на русском · 🇬🇧 English docs

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

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:

nicebot new mybot && cd mybot && python bot.py

Ichida nimalar bor

To'liq ro'yxat va qo'llanma: hujjatlar sayti (uz / ru / en).

Yana misollar

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

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