RealV
RealV

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

Подсветка синтаксиса, автодополнение скобок и быстрый запуск .rv программ прямо из редактора

Расширение создано для того, чтобы сделать процесс написания кода на RealV максимально комфортным. Оно интегрируется напрямую в интерфейс VS Code, предоставляя привычный визуальный отклик и базовые инструменты разработчика.

Постоянная установка

Для повседневной работы удобнее установить расширение в основной редактор. Два варианта:

Способ 1 — скопировать в папку расширений

Скопируйте папку vscode-extension в:

  • Windows: %USERPROFILE%\.vscode\extensions\realv-0.1.0
  • Linux / macOS: ~/.vscode/extensions/realv-0.1.0

Перезапустите VS Code.

Способ 2 — упаковать в .vsix

# Установите упаковщик, если его ещё нет
npm install -g @vscode/vsce

# В папке vscode-extension/ выполните:
vsce package

Получите файл realv-0.1.0.vsix и установите его:

code --install-extension realv-0.1.0.vsix

Возможности

  1. Подсветка синтаксиса для всех ключевых слов и встроенных функций языка RealV
  2. Подсветка строк, чисел и однострочных комментариев (// комментарий)
  3. Подсветка операторов: =>, ->, ?, :, ! и других
  4. Автозакрытие скобок ( ), [ ], { } и кавычек " "
  5. Кнопка ▶ («Run RealV Program») в правом верхнем углу редактора для быстрого запуска
  6. Определение языка RealV для файлов с расширением .rv

Структура расширения

Исходный код организован по стандартным рекомендациям платформы VS Code. Главным файлом является манифест package.json, описывающий регистрацию языка. Правила подсветки вынесены в TextMate-формат, логика запуска — в скрипт активации. 

vscode-extension/
├── package.json                    # манифест расширения
├── language-configuration.json     # правила для скобок, комментариев, отступов
├── extension.js                    # код активации и команда запуска
└── syntaxes/
    └── realv.tmLanguage.json       # грамматика TextMate для подсветки синтаксиса

Поддерживаемые элементы синтаксиса

Модуль использует регулярные выражения TextMate для точного распознавания конструкций языка. Цвета ключевых слов и операторов автоматически подстраиваются под текущую тему VS Code.

Управление и константы return delay force true false
Массивы и коллекции length head tail append remove contains slice get
Файловый I/O readFile writeFile appendFile
Операторы => -> ? : ! == < > + - * / =

Запуск в режиме разработки

Если вы хотите внести изменения в расширение — добавить ключевые слова, изменить правила автоотступов или улучшить команду запуска — используйте встроенный механизм отладки VS Code. Это позволит тестировать изменения в изолированном окружении, не затрагивая основной редактор.

  1. Откройте папку vscode-extension/ в VS Code: 
    code путь/к/проекту/vscode-extension
  2. Нажмите F5 (или Run → Start Debugging).
  3. Откроется новое окно VS Code с активным расширением — оно называется [Extension Development Host].
  4. Откройте любой файл .rv (например, examples/closures.rv) и убедитесь:
    • ключевые слова и операторы подсвечиваются;
    • в правом нижнем углу отображается язык RealV;
    • на верхней панели видна кнопка запуска ▶.

Команда запуска

Расширение регистрирует команду Run RealV Program, которая запускает текущий .rv-файл через интерпретатор, используя CLI проекта. Больше не нужно каждый раз переключаться в терминал и прописывать путь вручную.

  • Кнопка ▶ в панели заголовка редактора при открытом .rv-файле.
  • Через палитру команд: Ctrl+Shift+P → Run RealV Program.
Убедитесь, что в настройках расширения указан корректный путь до проекта RealV.Cli, иначе команда запуска не сможет найти интерпретатор.