FoxLang/README.md

🦊 FoxLang

FoxLang — современный интерпретируемый язык программирования общего назначения с поддержкой пользовательских функций, модульной системы и строгой типизацией.

✨ Ключевые возможности

• 🔧 Пользовательские функции: Полная поддержка функций с параметрами и возвратом значений
• 📁 Модульная система: Подключение библиотек через include("lib.fox") с поддержкой пользовательских функций
• 🔤 Современный синтаксис: Идентификаторы с подчеркиваниями (user_name, get_data)
• 📦 Массивы: Встроенная поддержка создания, чтения и записи массивов
• 🔄 Управление потоком: Циклы while, for и условия if/else
• 🔢 Строгая типизация: int, float, string, bool, void с автоматическим приведением
• 🧠 Логические операторы: Поддержка &&, ||, ! для boolean логики
• 🛠 Безопасность: Защита от крашей, информативные ошибки синтаксиса
• 🎲 Встроенные функции: Математика, ввод/вывод, генерация чисел, чтение файлов

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

1. Сборка

cd src
g++ main.cpp Lexer.cpp Parser.cpp -o foxlang

2. Запуск

./foxlang script.fox

💻 Примеры кода

Пользовательские функции

int factorial(int n) {
    if (n <= 1) {
        return 1;
    }
    return n * factorial(n - 1);
}

void main() {
    int result = factorial(5);
    print("5! = " + result);
}

main();

Работа с массивами

void bubble_sort(array arr, int size) {
    int i = 0;
    while (i < size - 1) {
        int j = 0;
        while (j < size - i - 1) {
            if (get(arr, j) > get(arr, j + 1)) {
                int temp = get(arr, j);
                set(arr, j, get(arr, j + 1));
                set(arr, j + 1, temp);
            }
            j = j + 1;
        }
        i = i + 1;
    }
}

Модульная система

// math_lib.fox
int add(int a, int b) {
    return a + b;
}

float average(int a, int b) {
    return (a + b) / 2.0;
}

// main.fox
include("math_lib.fox");

int sum = add(10, 20);
float avg = average(15, 25);
print("Sum: " + sum + ", Average: " + avg);

Чтение файлов

// config.txt содержит: server_port=8080
string config = read_file("config.txt");
print("Config: " + config);

// Проверка успешного чтения
if (config != "") {
    print("✅ Config loaded successfully");
} else {
    print("❌ Failed to load config");
}

FastAPI-подобный веб-сервер

// Подключение сетевой библиотеки
include("src/net.fox");

// Обработчики API
void api_home() {
    json_response("{\"message\":\"🦊 Welcome to FoxLang API!\"}");
}

void api_users() {
    json_response("{\"users\":[{\"id\":1,\"name\":\"Alice\"}]}");
}

// Запуск сервера
void main() {
    start_server(8080);
    register_get("/", "api_home");
    register_get("/users", "api_users");
    print("🚀 Server: http://localhost:8080");
}

main();

📂 Структура проекта

• src/ — Исходный код интерпретатора (C++)
• test/ — Тесты функциональности
• doc/ — Документация
• CHANGELOG.md — История изменений
• DOCUMENTATION.md — Полная документация языка

🤖 Telegram Bot

FoxLang поставляется с Telegram ботом, написанным на чистом FoxLang!

Быстрый запуск бота:

# Настройте токен бота
cd telegram_bot
nano token.txt  # Вставьте токен от @BotFather

# Запустите бота
./run_bot.sh

Подробнее: telegram_bot/README.md

🧪 Тестирование

# Запуск всех тестов
./test_all.sh

# Отдельные тесты
./src/foxlang test/variables.fox      # Тест переменных и типов
./src/foxlang test/functions.fox      # Тест пользовательских функций
./src/foxlang test/arrays.fox         # Тест массивов
./src/foxlang test/control_flow.fox   # Тест циклов и условий
./src/foxlang test/math_operations.fox # Тест математических операций
./src/foxlang test/modules.fox        # Тест модульной системы
./src/foxlang test/builtin_functions.fox # Тест встроенных функций

---

Author: SkrinVex
License: MIT