1C:Drive Test Helper

Помощник для тестов 1C:Drive

Помощник для разработки и управления регрессионными тестами 1C:Drive в VS Code. Ускоряет навигацию между сценариями, создание новых сценариев по шаблонам и управление фазами и сборкой для тестовых запусков.

Возможности

Работа с текстом сценариев:

• Автодополнение и Подсказки:

  • Предлагает варианты шагов Gherkin из Vanessa Automation по мере ввода (используется Fuzzy Match).
  • Показывает описание шага из библиотеки шагов Vanessa Automation при наведении мыши на строку шага в YAML файле.

• Быстрая Навигация:

  • Открыть сценарий: Находясь на строке вида And ИмяСценария, можно быстро открыть соответствующий .yaml файл, где определено Имя: "ИмяСценария".
  • Найти вызовы текущего сценария: Из текущего файла сценария (scen.yaml) можно быстро увидеть список всех мест (And Имя...), где используется этот сценарий.

• Создание Сценариев по Шаблонам:

  • Создать вложенный сценарий:
    • Вызывается из контекстного меню или палитры команд (1C:Drive - Создать вложенный сценарий).
    • Запрашивает Имя (может предзаполняться, если команда вызвана с заранее написанной строки вызова And ...), Номерной код теста и Родительскую папку.
  • Создать главный сценарий:
    • Вызывается из контекстного меню или палитры команд (1C:Drive - Создать главный сценарий).
    • Запрашивает Имя главного сценария, метаданные для Phase Switcher (Имя фазы/вкладки, Порядок сортировки, Состояние по умолчанию) и Родительскую папку.
    • Автоматически создает структуру:
      • <Родительская папка>/<Имя>/scen.yaml
      • <Родительская папка>/<Имя>/test/<Имя>.yaml

• Вставка Кода (Сниппеты):

  • Вставить ссылку на вложенный сценарий: Быстро вставляет блок в секцию ВложенныеСценарии (вызывается по Ctrl+Alt+N или Command+Option+N или из контекстного меню).
  • Вставить параметр сценария: Быстро вставляет блок в секцию ПараметрыСценария (вызывается по Ctrl+Alt+M или Command+Option+N или из контекстного меню).
  • Вставить новый UID: Генерирует и вставляет новый UUID v4 в текущую позицию курсора (вызывается по Ctrl+Alt+U или Command+Option+U или из контекстного меню).

Панель 1C:Drive Test Helper:

Для открытия, нажмите на иконку расширения в боковой панели (Activity Bar).

Phase Switcher:

Развитие приложения Phase Switcher внутри расширения для VS Code.

Главное отличие - больше нет необходимости во внешних файлах конфигурации, все происходит автоматически!

• Назначение: Позволяет быстро включать и выключать наборы тестов для разных запусков.
• Обнаружение тестов: Расширение сканирует папку tests/RegressionTests/Yaml/Drive/ (поэтому VS Code нужно открывать в корне проекта!).
• Метаданные тестов: Для отображения теста в Phase Switcher, файл scen.yaml должен содержать строку Имя: "Имя теста" и специальные комментарии-маркеры:

  # PhaseSwitcher_Tab:            # Обязательно - Название вкладки в UI/тестовой фазы
  # PhaseSwitcher_Default:        # Необязательно - Включен ли тест по умолчанию (true/false)
  # PhaseSwitcher_OrderOnTab:     # Необязательно - Порядок внутри фазы
  

• Интерфейс:
  • Тесты сгруппированы по фазам в древовидном представлении (Tree-View). Каждая фаза является раскрывающейся группой.
  • В заголовке каждой группы тестов отображается счетчик включенных тестов в данной фазе.
  • Чекбоксы показывают текущее состояние теста (включен/выключен/не найден).
  • Жирный шрифт у названия теста указывает на то, что его состояние было изменено, но еще не применено.
  • Кнопки управления:
    • Обновить: Пересканировать файлы и проверить состояние на диске.
    • Настройки: Открыть настройки расширения.
    • Переключить все: Переключить состояние всех активных тестов во всех фазах.
    • Переключить фазу: Позволяют переключить тесты внутри конкретной фазы. Находятся справа от счетчика включенных тестов.
    • По умолчанию: Сбросить состояние всех тестов в соответствии с их маркером # PhaseSwitcher_Default:.
    • Применить изменения: Физически перемещает параметрические папки ./test/ для измененных тестов между директориями tests/RegressionTests/Yaml/Drive/ и RegressionTests_Disabled/Yaml/Drive/, тем самым переключает состояние теста.
  • По кнопке карандаша можно открыть сценарий в редакторе.
  • Статус-бар: Отображает текущий статус (загрузка, наличие изменений, результат применения).

Сборка Тестов:

• Позволяет запустить скрипт сборки (BuildScenarioBDD) с установленными параметрами.
• В настройках расширения можно указать параметры тестовой почты.
• Автоматически вычищает "ненужные" шаги из определенных тестов (001_Company, I_start_my_first_launch)
• Управление сборкой:
  • Выпадающее меню Accounting: можно выбрать тип бух.учета перед сборкой тестов.
  • Чекбокс Drive Trade: можно выбрать режим тестов для Production или Sales&Services.
  • Собрать тесты: запускает скрипт сборки.
• Отдельный статус-бар для процесса сборки.

Требования

• Visual Studio Code
• Проект открыт в корневой папке репозитория.
• Заполненные пути и параметры в настройках VS Code для секции "Сборка Тестов".
• Для сборки: Node.js и npm.

Настройка и использование

1. Установка:

   • Установить из Visual Studio Marketplace
   • Или Extensions View -> "..." -> "Install from VSIX..." -> Выберите скачанный/собранный .vsix файл.

2. Настройка:
   В настройки расширения можно перейти стандартным методом через общие настройки или по кнопке настроек с панели Activity Bar.

   • Включить панель "Phase Switcher": переключает отображение секции Phase Switcher в Activity Bar (по умолчанию вкл.)
   • Включить панель "Сборка тестов": переключает отображение секции Сборщика тестов в Activity Bar (по умолчанию вкл.)
   • Настройки тестовой почты:
     • Email Address: адрес почтового ящика, который используется в тестах
     • Email Password: пароль от почтового ящика, используемого в тестах. В целях безопасности задается отдельно через команду, сохраняется в безопасном хранилище VS Code (SecretStorage). Отдельной командой можно удалить из хранилища.
     • Email Incoming Server: Сервер входящей почты (EMailTestIncomingMailServer).
     • Email Incoming Port: Порт входящей почты (EMailTestIncomingMailPort).
     • Email Outgoing Server: Сервер исходящей почты (EMailTestOutgoingMailServer).
     • Email Outgoing Port: Порт исходящей почты (EMailTestOutgoingMailPort).
     • Email Protocol: Протокол почты, IMAP или POP3 (EMailTestProtocol).
   • Настройки базы сборки:
     • Empty Infobase: Путь к каталогу пустой файловой информационной базы, на которой будет запускаться обработка сборки сценариев (EmptyInfobasePath).
     • Db User: Имя пользователя для подключения к пустой ИБ (DBUser).
     • Db Password: Пароль пользователя для подключения к пустой ИБ (DBPassword).
     • Split Feature Files: Значение для SplitFeatureFiles (по умолчанию выкл.)
   • Настройки системных путей:
     • Build Path: Путь к папке для собранных тестов (BuildPath).
     • one CEnterprise Exe: Полный путь к исполняемому файлу 1cv8.exe (Windows) или 1cestart (macOS).

3. Команды:

   • Большинство команд доступны через контекстное меню (правый клик в редакторе) или палитру команд (Ctrl+Shift+P или Command+Shift+P, начните вводить 1C:Drive).
   • Для навигации и вставки могут использоваться горячие клавиши (проверьте или настройте их в Keyboard Shortcuts).

4. Phase Switcher:

   • Откройте через иконку в Activity Bar.
   • Выберите нужную фазу из выпадающего списка.
   • Отметьте/снимите отметки у тестов. Названия измененных тестов станут жирными.
   • Нажмите Применить изменения.
   • Используйте Обновить, если вы вручную изменили структуру папок тестов.

5. Сборка Тестов:

   • Откройте через иконку в Activity Bar.
   • Выберите режим бух.учета Accounting
   • (опционально) Выберите режим DriveTrade
   • Нажмите Собрать тесты

Скриншоты

Панель в Activity Bar

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

Автодополнение строк

Окно описания шага

Известные Проблемы

• При создании нового Главного сценария, список тестов в Phase Switcher нужно обновить вручную через кнопку Обновить.
• Сборка тестов под macOS выполняется гораздо дольше, чем на Windows (скорее всего, проблема платформы). Также из-за особенностей платформы 1С на macOS, отслеживание статуса выполнения сборки происходит путем отслеживания создания файла результата, а не по завершению процесса 1С.
• Работа на Linux не проверялась.