Fastgramm

Максимально простая библиотека для Telegram ботов на Python**

📦 Установка

pip install fastgramm

Скопируйте файл fastgramm.py в ваш проект.

from fastgramm import *

🚀 Быстрый старт

from fastgramm import FastGrammBot, snd, btn, ifm

bot = FastGrammBot("YOUR_BOT_TOKEN")

# Создаём кнопку
btn("Привет", snd("Здравствуй!"))

# Реакция на текст
ifm("Как дела?", snd("Хорошо!"))

bot.run()

📚 Полное описание функций

🔧 Основные функции

📨 Отправка сообщений

⌨️ Клавиатуры

🎯 Условные обработчики

🖼️ Медиа

✏️ Редактирование и удаление

⏰ Таймеры и периодические действия

🎮 Примеры использования

Пример 1: Эхо-бот с клавиатурой

from fastgramm import FastGrammBot, snd, btn, ifm, any, last

bot = FastGrammBot("TOKEN")

btn("Помощь", snd("Я эхо-бот. Просто напиши что-нибудь"))
ifm(any, snd(lambda: f"Ты написал: {last()}"))

bot.run()

Пример 2: Бот с инлайн-меню

from fastgramm import FastGrammBot, snd, btn, inbs, clr

bot = FastGrammBot("TOKEN")

def main_menu():
    inbs("Главное меню",
        "Профиль", snd("Имя: Пользователь"),
        "Настройки", snd("Настройки пока не готовы"),
        "Выход", clr()
    )

btn("Меню", main_menu)
btn("Назад", main_menu)

bot.run()

Пример 3: Отложенные действия

from fastgramm import FastGrammBot, snd, btn, after, edit, dlt

bot = FastGrammBot("TOKEN")

btn("Временное сообщение", 
    snd("Это сообщение исчезнет через 3 секунды"),
    dlt_delay(3)
)

btn("Отложенный ответ",
    after(5, snd("Привет через 5 секунд!"))
)

btn("Редактор",
    snd("Старый текст"),
    after(3, edit("Новый текст!"))
)

bot.run()

Пример 4: Медиа бот

from fastgramm import FastGrammBot, snd, btn, pic, album

bot = FastGrammBot("TOKEN")

btn("Котик", pic("https://cataas.com/cat"))
btn("Альбом", album(["photo1.jpg", "photo2.jpg", "photo3.jpg"]))
btn("Моя геолокация", location(55.751244, 37.618423))

bot.run()

Пример 5: Полноценный бот-помощник

from fastgramm import (
    FastGrammBot, snd, btn, ifm, any, 
    last, clr, inb, after
)

bot = FastGrammBot("TOKEN")

# Приветствие
ifm("/start",
    snd("👋 Привет! Я бот-помощник.\nИспользуй /help для списка команд"),
    btn("Помощь", snd("/help - справка\n/about - о боте"))
)

# Справка
ifm("/help", snd("📋 Команды:\n/start - начать\n/about - о боте\n/clear - очистить"))

# О боте
ifm("/about", snd("🤖 Бот создан на Fastgram v1.0.2\nПростая библиотека для Telegram ботов"))

# Очистка клавиатуры
ifm("/clear", clr())

# Подтверждение действия
def confirm():
    inb("Вы уверены?", "Да", snd("Действие выполнено"))
    inb("Вы уверены?", "Нет", clr())

btn("Важное действие", confirm)

# Эхо (для всего остального)
ifm(any, snd(lambda: f"📝 Эхо: {last()}"))

bot.run()

⚠️ Важные замечания

1. Порядок инициализации — сначала определите все ifm и кнопки, затем вызовите bot.run()

2. Функция last() — работает только внутри обработчиков ifm и действий кнопок

3. edit() и dlt() — работают только с последним сообщением, отправленным ботом

4. after() и every() — работают асинхронно, не блокируют основной поток

5. wait() — блокирует выполнение, используйте after() для неблокирующих задержек

6. Кнопки — после вызова clr() клавиатура удаляется, кнопки нужно создавать заново