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 с помощью нашего расширения:

• GitHub
• VisualStudio Marketplace

TODO

• docstrings
• f strings

Лицензия

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