Описание изменений релиза 1.5.0

Система автодополнения

Пакет добавляет ряд удобств при работе с конфигурацией, разложенной на исходные файлы, или скриптами .os.
Данные возможности работают для процедур и функций общих модулей и глобального контекста, а так же методов модулей менеджеров. При открытии файлов .bsl и .os по каталогу проекта начинает выстраиваться кэш процедур:

После заполнения индикатор примет следующий вид:

При необходимости ручного обновления кэша текущего проекта вы можете выполнить команду Language 1C(BSL): Update reference cache.

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

По нажатию клавиши F12 или выполнив команду Перейти к определению можно осуществить переход к месту определения вызываемого метода:

Если система автодополнения не может однозначно определить вызываемый метод (например, экспортный метод модуля объекта), будет производиться поиск по имени метода. В случае нахождения такого метода в единичном экземпляре, будет осуществлен автоматический переход. Если таких методов будет показано несколько, то появится окно с возможными вариантами перехода:

Поиск мест использования процедур

По нажатию комбинации клавиш Shift+F12 или выполнив команду Найти все ссылки можно получить список мест использования указанного метода:

Информация о процедуре

При наведении курсора на процедуру появится всплывающее окно, показывающее информацию о данной процедуре. В окне информации отразится сигнатура данной процедуры, месторасположение, описание и (в случае соблюдения стандарта описания параметров) информация о параметрах и возвращаемом значении:

Предварительный просмотр определения процедуры

При наведении курсора на процедуру с зажатой клавишей Ctrl появится всплывающее окно, показывающее начало реализации данной процедуры:

Автодополнение через точку

При обращении к общему модулю или модулю менеджера "через точку" отобразится список экспортных процедур и функций данного объекта.
Есть возможность посмотреть информацию по данной процедуре (нажав Ctrl+Пробел).
Для менеджеров классов доступно отображение списка объектов данного класса:

Подсказка по параметрам процедур

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

Поиск определения

По нажатию комбинации клавиш Ctrl+T или выполнив команду Показать все символы можно осуществить поиск процедуры или функции в проекте:

Количество результатов поиска ограничено 1000 элементов.

Поддержка английского языка конфигурации

Все описанные выше возможности автодополнения работают и с английским вариантом встроенного языка.
Для полноценной работы переопределите свойство language-1c-bsl.languageAutocomplete в "Параметрах рабочей области" (файл settings.json в подкаталоге .vscode).

Сервисные возможности

Создание описания метода

Для методов доступна команда автоматического создания описания метода по стандартам 1С.
Для активации команды нужно поставить курсор внутрь метода и выполнить команду Language 1C (BSL): Create comment to current method:

Синтаксис-помощник по функциям глобального контекста

В пакет встроен базовый синтаксис-помощник по функциям глобального контекста.
Для его вызова откройте командную панель (Ctrl+Shift+P) и выберите команду Language 1C(BSL): Show syntax-helper или воспользуйтесь комбинацией Ctrl+F1. В открывшемся окне введите интересующую вас процедуру или функцию:

Имеется возможность показа справки текущего метода под курсором. Пример работы через комбинацию горячих клавиш:

Новые настройки пакета

Добавлены настройки:

• language-1c-bsl.onescriptPath
  Путь к исполняемому файлу oscript. Заполните это свойство, если oscript отсутствует в переменной окружения PATH.
  По умолчанию не заполнено.
• language-1c-bsl.lintOtherExtensions
  Список расширений (помимо .os), к которым применяется линтер OneScriptLint.
  Формат: строка, разделенная запятыми - bsl,txt.
  По умолчанию не заполнено.

Настройка заменила собой настройку language-1c-bsl.lintBSLFiles из прошлых версий пакета.

• language-1c-bsl.linterEntryPoint
  Точка входа для OneScriptLint, значение ключа -env. Подробнее на http://oscript.io
  Формат: строка - относительный (от корня проекта) или абсолютный путь к каталогу.
  По умолчанию не заполнено.
• language-1c-bsl.languageAutocomplete
  Язык автодополнения для функций глобального контекста и классов.
  Формат: строка. Доступные значения: "en", "ru"
  Значение по умолчанию: "ru"
• language-1c-bsl.rootPath
  Путь по умолчанию к корню файла конфигурации (./src/cf) относительно корня проекта. Может потребоваться для заполнения в случае работы с несколькими каталогами исходных кодов конфигурации в рамках одного проекта.
  Формат: строка.
  По умолчанию не заполнено.

Все эти настройки можно задавать в "Параметрах рабочей области" (файл settings.json в подкаталоге .vscode).

Включение подсветки для txt-файлов через ассоциации VS Code

В VS Code 1.0 появилась возможность ассоциировать файлы с определенным расширением с конкретным языком. Если вы используете линейный формат выгрузки конфигурации или работаете с 1с-файлами не в расширениях bsl и os, то вы можете настроить ваш редактор для автоматического включения подсветки 1C (BSL).
Выберите команду Файл -> Параметры -> Параметры рабочей области.

В каталоге вашего проекта в папке .vscode появится файл settings.json, если его там еще не было

Для ассоциации всех файлов с расширением txt как файлов 1C (BSL) в открывшемся файле settings.json добавьте секцию настроек:

"files.associations": {
  "*.txt": "bsl"
}

Так же вы можете ограничить подкаталог для применения данной ассоциации.
Для этого укажите настройку таким образом:

"files.associations": {
  "/path to file/*.txt": "bsl"
}

Оба типа настроек можно комбинировать.

Автоматическая вставка скобок

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