Боли псто( Кто-нибудь научился готовить swagger без боли?
Я даже не имею ввиду генерацию сервера или клиента (пару раз пытался, на код без кровавых слез смотреть нельзя), а тупо генерацию спеки по серверному коду, которую можно импортнуть к примеру в postman и отдать фронтам. Третий раз я это пытаюсь сделать, сначала в одном проекте на python но было давно детали не помнб помню что был гемморой. Затем проект на node, nestjs, было +/- ок но весь код моделей и контроллеров пришлось обвешать аннотациями. Сейчас бэкенд на go, и я почти обрадовался что go-swagger позволяет спеку отдельным package оформлять не засирая код, но бляха муха писать yaml в комментариях - то еще удовольствие и главное пока спеку не проверишь в swagger ui гарантировать что там все +/- ок невозможно.
Отдельная боль это авторизация, еще ни разу не удалось сделать такую спеку по которой postman поймет автоматом на каких методах какая авторизация, но это я уже на postman грешу.
Вобщем уже посещвет мысль не выпендриваться, забить и писать спеку руками если она очень нужна, но думаю может все таки есть тайное знание в природе?)
А сваггер спека «руками» это и есть тот самый же yaml. Плюс у command line утилиты от свагера можно валидировать получившийся json/yaml, это в ci/cd встраивается.
Про код сгенерированный ими - правда немного грустно, мы используем, как контракт между микросервисами и живет вроде ок.
На своём сайд проекте - пишу руками, и также в постман заливаю. Кстати, послушал бы как эту часть автоматизируете, через postman api?