Swagger 2.0

---Этот проект содержит реализацию на языке Golang для Swagger 2.0 (также известной как OpenAPI 2.0). Он предоставляет инструменты для работы со спецификациями Swagger.Swagger — это простое, но мощное представление вашего RESTful API.

Документация

https://goswagger.io

Основные возможности

go-swagger предоставляет сообществу Go полный набор полностью функциональных, высокопроизводительных компонентов для работы с API Swagger: сервер, клиент и модель данных.

• Создает сервер на основе спецификации Swagger
• Создает клиента на основе спецификации Swagger
• Создает консольное приложение (инструмент командной строки) на основе спецификации Swagger (альфа-версия)
• Поддерживает большинство возможностей, предлагаемых JSON Schema и Swagger, включая полиморфизм
• Создает спецификацию Swagger на основе аннотированного кода Go
• Дополнительные инструменты для работы со спецификацией Swagger
• Богатые возможности кастомизации с расширениями от поставщиков и кастомизируемыми шаблонами

Наше внимание при генерации кода направлено на создание идиоматичного, быстрого кода на Go, который хорошо работает с golint, go vet и другими инструментами.

Подробнее.

Статус проекта

Этот проект поддерживает OpenAPI 2.0. На данный момент он не поддерживает OpenAPI 3.x.

go-swagger теперь имеет полный набор функций и стабилизировал свой API.

Большинство функций и основных блоков находятся в стабильном состоянии, с богатым набором тестов CI.Комьюнити go-openapi активно продолжает внедрять исправления и улучшения в этот кодовой базис.

Ещё много места для улучшений: приветствуем новых участников и pull requests. Вы также можете связаться с поддержкой на нашем канале Slack.

Установка

go install github.com/go-swagger/go-swagger/cmd/swagger@latest

go-swagger также доступен как двоичный файл или образ Docker, а также может быть установлен из исходного кода: подробнее.

Пробуйте

Попробуйте go-swagger в бесплатной онлайн среде используя Gitpod:

Лицензия

Инструмент сам по себе лицензируется под Apache Software License 2.0.

Как и Swagger, это не распространяется на код, сгенерированный этим инструментом. Этот код целиком ваш, вы можете лицензировать его так, как считаете нужным.

Сканирование лицензий зависимостей