FLK (File Language Kit)

FLK - это библиотека для парсинга и работы с файлами в формате FL (File Language), предназначенная для упрощения работы со структурированными данными.

Основные возможности

Парсинг файлов FL: Чтение и анализ файлов с расширением .fl, содержащих переменные и константы.
Простота использования: Импортируйте Parser и начните парсинг файлов с минимальной настройкой.
Расширяемость: Легко адаптируйте для парсинга различных форматов данных.

Установка

Установите через pip:

pip install flk

Для последней версии:

pip install git+https://github.com/FlacSy/flk

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

Импорт и использование парсера

# Импортируем класс Parser из модуля flk
from flk import Parser

# Создаем экземпляр парсера
parser = Parser()

# Задаем имя переменной, значение которой мы хотим изменить
variable_name = "num_1"

# Парсим файл "example.fl" и анализируем его содержимое
parser.parse_file("example.fl")

# Изменяем значение переменной с именем, указанным в variable_name, на 3
parser.edit_var_value(variable_name, 3)

# Получаем объект переменной с именем, указанным в variable_name
my_var = parser.get_var(variable_name)

# Получаем тип переменной
var_type = my_var.get_type()

# Получаем значение переменной
var_value = my_var.get_value()

# Создаем переменную 
parser.create_var("my_custom_var", "str", "Hello World!")

# Удаляем переменную
parser.remove_var("my_custom_var")

# Выводим информацию о переменной
print(f"Тип переменной '{variable_name}': {var_type}")
print(f"Значение переменной '{variable_name}': {var_value}")

Командная строка

Используйте FLK из командной строки:

python -m flk example.fl

Синтаксис файла FL

Файлы FL используют простой и понятный синтаксис для определения переменных и констант:

Константы

Определяются с ключевым словом const, за которым следует тип и значение:
```
const PI(float) = 3.14159
```

Переменные

Определяются с указанием типа и значения:
```
my_string(str) = "Hello, world!"
```

Импорты

Импорт других .fl файлов:
```
(import) module_name
```

Арифметические и логические операции

Поддерживаются базовые арифметические (+, -, *, /, %) и логические операции (<, >, =):
```
my_sum(float) = $my_int + $my_float
my_logic_bool(bool) = $my_int < $my_float
```

Расширение для Visual Studio Code

Улучшите визуализацию синтаксиса файлов .fl с помощью нашего расширения:

TODO

docstrings
f strings

Лицензия

FLK распространяется под Apache License Version 2.0. Подробности лицензии доступны в файле LICENSE.

FlacSy/FLK