Telegram bot maded using FoxLang
  • Dockerfile 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-24 00:10:09 +05:00
.dockerignore push 2026-09-23 19:31:55 +05:00
.env first commit 2026-09-23 14:50:51 +05:00
docker-compose.yml feat(docker): add Dockerfile, compose configs, and configure port 7070 2026-09-23 21:44:14 +05:00
docker.yaml feat(docker): add Dockerfile, compose configs, and configure port 7070 2026-09-23 21:44:14 +05:00
Dockerfile feat(docker): add Dockerfile, compose configs, and configure port 7070 2026-09-23 21:44:14 +05:00
main.fox Supercharge FoxBot to showcase all FoxLang language features 2026-09-24 00:10:09 +05:00
README.md Supercharge FoxBot to showcase all FoxLang language features 2026-09-24 00:10:09 +05:00

🦊 FoxBot — Telegram Webhook-бот на FoxLang

Полнофункциональный Telegram-бот на языке программирования FoxLang 5.5.3, задействующий максимум возможностей языка: HTTP/webhook-сервер, исходящие REST-запросы (включая работу с внешними API и Telegram sendPhoto), работу с массивами, рекурсивные алгоритмы, файловое логирование событий, встроенный JSON-парсер с поддержкой UTF-8 и эмодзи, работу со строками и математикой.

Сервер работает на порту 7070.


🚀 Возможности FoxLang, используемые в боте

  1. Модульная система (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).
  2. Структуры данных и алгоритмы:
    • Массивы: создание (array name size;), запись (set(arr, idx, val)), чтение (get(arr, idx)), размер (size(arr)).
    • Рекурсия: вычисление чисел Фибоначчи (fib(n)) и факториала.
    • Файловая система: персистентное логирование действий пользователей в bot_events.log через append_file и read_file.
  3. Внешние 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