JMCC Compiler

compilation/decompilation, syntax highlighting, and functions based on the Language Server Protocol for JustMC compiler

Возможности

1. Подсветка синтаксиса

• Настраиваемая подсветка синтаксиса для файлов .jc, упрощающая чтение и навигацию по коду.

2. Автодополнение

• Контекстно-зависимое автодополнение на основе протокола языкового сервера.

3. Информация при наведении

• Подробная информация об JMCC объектах при наведении курсора.
• Отображает документацию, сигнатуры методов и детали классов из кода или базы данных.

4. Переход к определению

• Быстрая навигация к определениям JMCC объектов одним кликом (по умолчанию клавиша CTRL).

5. Подсказки по сигнатурам

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

6. Встроенные подсказки

• Автоматически отображают имена параметров рядом с аргументами.

7. Компиляция и декомпиляция

• Компиляция .jc файлов в:
  • URL для публикации или обмена.
  • Локальные JSON файлы для хранения на устройстве.
• Декомпиляция .json файлов обратно в формат JustCode.
• Настраиваемые пути вывода и режимы компиляции через файл .jmccconfig.json.

8. Быстрая компиляция

• Компиляция активного .jc файла клавишей F5.
• Сохранение и компиляция .jc файла в указанное место клавишей F5.

9. Конфигурация рабочего пространства

• Автоматическое создание и управление файлом .jmccconfig.json в папке .vscode вашего проекта.
• Настраиваемые параметры:
  • Путь к компилятору Python.
  • Режим компиляции по умолчанию (UPLOAD или SAVE).
  • Путь для сохранения скомпилированных файлов.
  • Очистка терминала перед выполнением команд.

Установка

1. Установите расширение из Visual Studio Code Marketplace.
2. Настройте файл .jmccconfig.json в папке .vscode вашего проекта, указав путь к компилятору Python.

Команды

Расширение предоставляет следующие команды, доступные через палитру команд (Ctrl+Shift+P) или контекстное меню:

• JMCC: Compile as URL — компилирует и загружает в облако файл .jc.
• JMCC: Compile as File — компилирует .jc и загружает .json на устройство.
• JMCC: Decompile File — декомпилирует .json файл в .jc.
• JMCC: Compile Active File — компилирует текущий открытый .jc файл.
• JMCC: Save and upload — сохраняет на устройство и загружает в облако .jc файл.

Контекстное меню

Щёлкните правой кнопкой мыши на файл .jc или .json в проводнике, чтобы получить доступ к командам компиляции и декомпиляции.

Горячие клавиши

• F5: Запуск активного файла (компиляция для .jc или декомпиляция для .json).

Конфигурация

Настройте файл .jmccconfig.json в папке .vscode вашего проекта:

{
  "compilerPath": "COMPILER_PATH",
  "defaultCompileActiveFileMode": "COMPILE_TYPE",
  "compilerOutputPath": "OUTPUT_FILE",
  "clearTerminalBeforeCommand": true
}

Разработка

Для участия в разработке или локальной сборки расширения:

1. Клонируйте репозиторий:

   git clone <URL-репозитория>
   

2. Установите зависимости:

   npm install
   

3. Упакуйте расширение для распространения:

   vsce package
   

Поддержка

Для вопросов, предложений или сообщений об ошибках создайте задачу в GitHub-репозитории.