Автора проекта я знаю давно (к сожалению, только виртуально), со времён подкаста "Цинковый прод" (который сейчас канул в лета), но Антон и тогда, и сейчас весело и с душой делился и делится своим большим опытом (сейчас тут @crossjoin). Короче, Антон красавчик поэтому я с удовольствием даю ему слово.
Слово автору @antonokolelov
---
Привет всем! @rusdacent (респект ему форева) дал мне возможность рассказать о своём плагине (https://plugins.jetbrains.com/plugin/27118-openapi-gui-editor) для редактирования OpenAPI, и вот моя стори.
По жизни я в основном бекендер на Go (в микросервисной архитектуре).
Несколько лет назад мы прикрутили swagger-анннотации к нашему коду и генерили по ним спеку openapi для других команд. Но удовлетворения это не приносило: уродливые аннотации, в которых легко ошибиться, что-то забыть и так далее. У этих аннотаций, по крайней мере для Go, свой какой-то дебильный синтаксис, хуже ямла (хотя казалось бы это невозможно).
Решили мы попробовать делать наоборот, api design first подход, т.е. сделать руками openapi и генерить из него бойлерплейт код, а логику дописывать отдельно. Заодно это давало бы возможность показать кому-то API до самой разработки.
Но, попробовав редактировать ямлы openapi руками, я приуныл. 10-кратная вложенность получается сразу же, даже для довольно простого API, и вот ты уже не понимаешь, что ты редактируешь, плюс эти шизоидные правила ямла, где легко случайно сделать openapi невалидным.
Можно разбивать док на части, а потом собирать, но это какая-то тоже лишняя возня.
Поэтому я решил сделать свой пет проект и заодно заработать на пиво - OpenAPI GUI Editor, (https://plugins.jetbrains.com/plugin/27118-openapi-gui-editor) плагин для продуктов JetBrains. Он позволяет делать OpenAPI с помощью кнопочек и формочек.
Пока что у меня всего два покупателя, но с помощью этого канала я
---