Telegram bot maded using FoxLang
- Dockerfile 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .dockerignore | ||
| .env | ||
| docker-compose.yml | ||
| docker.yaml | ||
| Dockerfile | ||
| main.fox | ||
| README.md | ||
🦊 FoxBot — Telegram Webhook-бот на FoxLang
Полнофункциональный Telegram-бот на языке программирования FoxLang 5.5.3, задействующий максимум возможностей языка: HTTP/webhook-сервер, исходящие REST-запросы (включая работу с внешними API и Telegram sendPhoto), работу с массивами, рекурсивные алгоритмы, файловое логирование событий, встроенный JSON-парсер с поддержкой UTF-8 и эмодзи, работу со строками и математикой.
Сервер работает на порту 7070.
🚀 Возможности FoxLang, используемые в боте
- Модульная система (
using):using server;— встроенный HTTP-сервер (get,post,body,respond,listen).using http;— исходящие HTTP-запросы (http_fetch,http_post_json).using env;— чтение окружения и.envфайла (env,secret,env_default).using log;— уровневое логирование (info,debug,warn,error).using json;— безопасный JSON-экранатор и парсер точечных путей (json_path,json_safe).using string;— сплит строк в массив (str_split), поиск подстрок (contains), замена (replace), длина (size), конвертация (to_int,strtoint).using math;— генерация случайных чисел (random), поиск максимума/минимума (max_int,min_int).using time;— замер времени выполнения и таймстемпы (unix_time_ms,sleep_ms).
- Структуры данных и алгоритмы:
- Массивы: создание (
array name size;), запись (set(arr, idx, val)), чтение (get(arr, idx)), размер (size(arr)). - Рекурсия: вычисление чисел Фибоначчи (
fib(n)) и факториала. - Файловая система: персистентное логирование действий пользователей в
bot_events.logчерезappend_fileиread_file.
- Массивы: создание (
- Внешние REST API:
- Отправка текста (
sendMessage) и фотографий (sendPhoto) через Telegram Bot API. - Получение случайных фото лис через API
https://randomfox.ca/floof/. - Получение фактов через API
https://catfact.ninja/fact.
- Отправка текста (
📋 Доступные команды в Telegram
| Команда | Описание | Возможность FoxLang |
|---|---|---|
/start |
Приветствие и знакомство с ботом | Маршрутизация, JSON, sendMessage |
/help |
Список всех команд с описанием | Форматирование строк |
/fox |
Фото случайной лисички | Внешний HTTP GET API + sendPhoto |
/cat |
Случайный факт о котиках | Внешний HTTP GET API + парсинг JSON |
/fact |
Случайный факт о лисах и FoxLang | Массивы array, random, get |
/calc <A> <op> <B> |
Калькулятор (+, -, *, /, %, max, min) |
str_split, парсинг аргументов, max_int, min_int |
/roll [min] [max] |
Бросок кубика / генератор чисел | random(min, max) |
/fib <N> |
Рекурсивные числа Фибоначчи с замером времени | Рекурсия, unix_time_ms |
/stats |
Статистика сообщений, аптайм и размер файла базы | read_file, size, счётчики |
/about |
Справка о FoxLang и архитектуре | Глобальные переменные |
/id |
Chat ID и Username пользователя | JSON path extraction |
/ping |
Проверка времени отклика бота | unix_time_ms дельта |
<любой текст> |
Эхо с заменой слов и подсчётом длины | replace, contains, size(text) |
🌐 Маршруты HTTP-сервера (порт 7070)
GET /health— проверка статуса сервиса, аптайма и количества обработанных запросов.GET /stats— расширенная JSON-статистика бота (сообщения, команды, размер логов).POST /telegram— приём входящих вебхуков от Telegram Bot API.
⚙️ Переменные окружения (.env)
Создайте файл .env в корне проекта:
TELEGRAM_BOT_TOKEN=1234567890:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
PORT=7070
FOXLANG_LOG_LEVEL=info
🐳 Запуск в Docker
С помощью Docker Compose:
docker compose up -d --build
Просмотр логов:
docker compose logs -f
Остановка:
docker compose down
С помощью Docker CLI:
docker build -t foxbot .
docker run -d \
--name foxbot \
--restart unless-stopped \
-p 7070:7070 \
--env-file .env \
foxbot
💻 Локальный запуск без Docker
foxlang main.fox