Skip to content

vanessa-opensource/vanessa-support

Repository files navigation

Vanessa-support

Тестирование GitHub release GitHub Workflow Status Статус Порога Качества Покрытие Строки кода

Приложение командной строки для генерации различных файлов на основании информации о поддержке метаданных в исходниках 1С-конфигурации в форматах Конфигуратор или EDT.

Vanessa open-sourceChat on Telegram vanessa_opensource_chat или oscript_library Chat on Telegram oscript_library - в этих чатах вы можете задавать любые вопросы разработчикам и активным участникам.

Возможности

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

Подобные файлы могут быть использованы для различных целей. Например, для дымового тестирования через Vanessa-ADD или для контроля исходников на внутренние стандарты вашей компании.

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

  • добавляется новый этап ci
  • запускается приложение vanessa-support, которое
    • читает файл поставщика из исходников проекта
      • а этот файл всегда актуален
    • генерит из него json-файл специального формата и сохраняет его в "правильное" место
      • для дымовых открытия формы и командного интерфейса - один формат и одно место
      • для прочих дымовых - другой формат и другое место
      • для других целей - 3й формат
      • и т.д.
  • далее запускаются уже непосредственно дымовые тесты
    • которые используют актуальные настройки для поддержки, а не устаревшие, ранее заполняемые вручную

Приложение vanessa-support запускается один раз или несколько для генерации нужного набора json-файлов.

Создание json-файлов - команда json

Например, команда vanessa-support json --format ДеревоИменМетаданных --src fixtures\simple-config result.json выдаст готовый json-файл для всех метаданных, которые могут быть изменены и не находятся в режиме чтения.

Будет сформирован следующий файл

{
    "Справочники": [
        "ПервыйСправочник"
    ],
    "Документы": [
        "ПервыйДокумент"
    ]
}

Отдельные генераторы-форматтеры

Пример API смотрите в файле src/Классы/ДеревоИменМетаданных.os

Для создания нового генератора используйте файл-шаблон генератора docs/ШаблонГенератораПоддержки.os