Плагины для Visual Studio Code для описания OpenAPI

Вообще описание OpenAPI-спецификации простая рутинная работа, которую можно поручать новичкам и где-то ИИ. Но я люблю иногда такие задачки оставлять на себе: когда постоянно работаешь с хаосом, рутина успокаивает и дает положительное подкрепление выполненной работы, среди долгоиграющих задач.

Но облегчать себе жизнь всё же нужно. И вот мой набор расширений для VS Code которые помогают в этом:

Редактор, проверка и валидация

🔧 YAML от RedHat🔧 Кажется, он всегда предустановлен. Но версия 1.18 косячная, лучше откатиться до 1.17. Это и редактор, и автодополнение, и переходы по $ref (в том числе между файлами). В целом может быть достаточно, если нет возможности ставить сторонние расширения.

🔧 OpenAPI (Swagger) Editor🔧 Есть шаблоны для новых документов, удобный редактор, очень нравится возможность ходить по дереву описанного документа.

🔧 Stoplight Spectral🔧 Линтер с готовыми правилами для OpenAPI. Фишка, что можно добавлять свои правила. Но пока я ленивая какашка, и не добавила в правила договорённостей в команде. Поэтому он меня часто раздражает, из-за своих правил. Но мы с коллегой договорились довести его до ума и встроить в процесс CI/CD (расскажу о результатах отдельно).

Предпросмотр

👀 Swagger Viewer 👀 Классика. Показывает, что же вы там понаписали и собирается ли это вообще. В последних версиях появился поиск — очень удобно.

Тестирование

🧪 Thunder Client 🧪 Простенький аналог Postman. Для большинства REST-задач мне хватает, плюс удобно, что всё прямо внутри VS Code.

Ну конечно еще ряд расширений для Git. Но там стандартный набор.

Вот такой нехитрый набор, который делает простую работу ещё проще. Рекомендую.

Расширения с ИИ для работы с OpenAPI-спецификацией ещё не искала, поэтому если знаете хорошие, делитесь!