8095tores / anti_swagger

библиотека для OneScript, которая преобразовывает описания сервиса по спецификации OpenApi в расширение

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ANTI_SWAGGER - конвертор OpenAPI Specification (OAS) в код 1С

Назначение

Трансформация OAS в файл расширения для 1С с использованием best practices проектирования систем.

Может испольоваться для поднятия mock-серверов на 1С.

Принцип работы

Проект ainti_swagger представляет собой консольное приложение на основе бибилотеки cli.

Также созможно использовать в виде бибилиотеки для разработки своих приложений (что пока кажется маловероятным).

Логика работы посторена на работе с исходными файлами конфигурации. OAS трансформируется в исходный файл конфигурации/расширения для 1С.

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

Приложение: anti_swagger
 Конвертор спецификации OAS в расширение 1С

Строка запуска: anti_swagger [ОПЦИИ]  КОМАНДА [аргументы...]

Опции:
  -v, --version         показать версию и выйти

Доступные команды:
  c, convert    Конвертация из OAS в код 1С

Для вывода справки по доступным командам наберите: anti_swagger КОМАНДА --help
Команда: c, convert
 Конвертация из OAS в код 1С

Строка запуска: anti_swagger c [ОПЦИИ] SRC TYPE NAME OUTPUT

Аргументы:
  SRC           Путь к входному файлу спецификаций (*.json)
  TYPE          Тип конвертации (по умолчанию to_cfe)
  NAME          Имя расширения (-Extension)
  OUTPUT        Путь к выходному файлу (*.cf|*.cfe)

Опции:
  -t, --tempdir         Путь к каталогу временных файлов
  -p, --platform        Версия платформы
  --pt, --postman       Спецификация из postman (по умолчанию false)

Живая команда

anti_swagger convert .\examples\OpenAPISpecicification.json to_cfe OAS2CFE .\examples\OAS2CFE.cfe

Cборка и установка

Установка из исходников

opm build .

opm install ./anti_swagger-0.0.6.ospx

Установка из хаба

opm install anti_swagger

TO DO

  • Реализовать конвертацию не только в расширение, но и в полноценную конфигурацию 1С
  • Реализовать поддержку коллекций Postman для создания кода 1С
  • Реализовать поддержку OAS в формате yaml
  • Реализовать поддержку OAS 2.0 и SWAGGER

About

библиотека для OneScript, которая преобразовывает описания сервиса по спецификации OpenApi в расширение


Languages

Language:1C Enterprise 100.0%