rusgramm 0.1.1

Русскоязычный фреймворк для создания Telegram ботов

Русграмм - Русскоязычный фреймворк для Telegram ботов

Русграмм - это фреймворк, который позволяет создавать Telegram ботов на русском языке с использованием интуитивно понятного синтаксиса.

Установка

pip install rusgramm

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

Создайте файл главный.рус:

из m импорт Русграмм, Команда, Текст

бот = Русграмм("YOUR_BOT_TOKEN")

@бот.сообщение(Команда("start"))
фун старт(сообщение):
    сообщение.ответ("Привет! Я бот на Русграмме 😄")

@бот.сообщение(Текст("привет"))
фун приветствие(сообщение):
    сообщение.ответ("Привет 👋")

если __имя__ == "__главный__":
    бот.запуск()

Запустите бота:

rusgramm

Основные конструкции

Импорты

из m импорт Русграмм, Команда, Текст

Функции

фун название_функции(параметры):
    # код функции

Условия

если условие:
    # код
иначе:
    # код

Циклы

для элемент в список:
    # код

пока условие:
    # код

Обработчики сообщений

Команды

@бот.сообщение(Команда("start"))
фун обработчик(сообщение):
    сообщение.ответ("Ответ на /start")

Текстовые сообщения

@бот.сообщение(Текст("привет"))
фун обработчик(сообщение):
    сообщение.ответ("И тебе привет!")

Все сообщения

@бот.сообщение()
фун обработчик(сообщение):
    сообщение.ответ("Получено сообщение")

Запуск

Автоматический поиск файла

rusgramm

Ищет файлы в порядке: бот главный.рус → главный.рус → любой .рус файл

Указание файла

rusgramm мой_бот.рус

Через Python

python -m runner мой_бот.рус

Переменные окружения

Установите токен бота через переменную окружения:

export BOT_TOKEN="your_token_here"

Тогда в коде можно не указывать токен:

бот = Русграмм()  # возьмет из BOT_TOKEN

Пример бота

из m импорт Русграмм, Команда, Текст

бот = Русграмм()

@бот.сообщение(Команда("start"))
фун старт(сообщение):
    сообщение.ответ("👋 Привет! Я бот на Русграмме")

@бот.сообщение(Команда("help"))
фун помощь(сообщение):
    сообщение.ответ("📋 Справка:\n/start - запуск\n/help - помощь")

@бот.сообщение(Текст("как дела?"))
фун как_дела(сообщение):
    сообщение.ответ("😊 Отлично! А у тебя?")

если __имя__ == "__главный__":
    бот.запуск()

Лицензия

MIT License