SWEET - это продукт для генерации Swagger (OpenApi) спецификации для конфигураций 1С.
Состав:
-
Документирующий комментарий - описание спецификации формируется на основании комментариев к функциям-обработчикам HTTP-запросов. Разработанный синтаксис и структура комментария максимально приближены к стандартам 1С.
-
Онлайн-редактор - редактор документирующего комментария для быстрого и безошибочного написания документирующего комментария с предпоказом в Swagger UI.
-
Генератор спецификации - бинарный файл приложения для генерации спецификации (CLI и GUI).
Не требует знания структуры спецификации. Чтобы описать http-сервис, достаточно написать комментарий к коду, который будет полезен разработчикам
Быстрое создание и поддержка документирующего комментария при помощи онлайн-редактора
Работает как с файлами проекта EDT, так и с файлами конфигурации, выгруженных из конфигуратора
Не требует установки стороннего ПО. Можно использовать на серверах с минимальным набором ПО, без доступа в Internet
Консольный и десктопный вариант приложения доступны для Windows, Linux и MacOs
Доступны примеры и сгенерированный json-файл спецификации для проекта EDT и файлов конфигурации.