gin-swagger
kin-openapi
Our great sponsors
gin-swagger | kin-openapi | |
---|---|---|
3 | 6 | |
3,565 | 2,383 | |
2.3% | 3.9% | |
4.7 | 8.5 | |
4 days ago | 7 days ago | |
Go | Go | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
gin-swagger
-
swaggo/swag alternative, but should generate OpenAPI 3.0 spec file
No I use this one https://github.com/swaggo/gin-swagger. It's with swagger 2.0, but I think it can be easily converted to OpenApi 3.0. I tried it once and the only thing it complained about was some simple "metadata" like contact person etc.
-
How to configure swagger UI so it doesn't need the URL?
I don't use Gin, but I took the canonical example from https://github.com/swaggo/gin-swagger#canonical-example, removed the url := ginSwagger.URL line entirely (and removed url from the next line), and it works as expected locally or when deployed in kubernetes (via kind) for me.
kin-openapi
-
Create Production-Ready SDKs With gRPC Gateway
We'll use the excellent kin-openapi Go library to convert the OpenAPI 2.0 schema to OpenAPI 3.0.
-
OpenAPI Generator allows generation of API client libraries from OpenAPI Specs
What is your language?
I've found kin-openapi to be good for Go:
https://github.com/getkin/kin-openapi
-
swaggo/swag alternative, but should generate OpenAPI 3.0 spec file
I recently used https://github.com/getkin/kin-openapi openapi2 and openapi2conv to convert the v2 yaml to v3 yaml.
-
Any good OpenAPI 3.x spec generator for a Go REST API?
This might not be very helpful, but I've have found every "generate spec from code" package to be limited sooner or later, and that's across languages. I finally settled on writing the spec file by hand, linting it in CI using openapi-cli, and using kin-openapi in Go tests to ensure responses match their schema.
-
What are your favorite packages to use?
oklog/ulid to generate IDs. coreos/go-oidc for validating JWTs I get from auth. google/go-cmp for comparing structs in tests (unless the project is already using Testify). spf13/pflag because life's too short for Go's flag handling. getkin/kin-openapi for validating reqests/responses against my OpenAPI spec (in tests).
-
Do you use swagger to generate backends?
Then define the corresponding YAML/JSON specification (again manually) either using Swagger 2.0 (with go-swagger) or OpenAPI 3 (with kin-openapi), and
What are some alternatives?
swag - Automatically generate RESTful API documentation with Swagger 2.0 for Go.
GoSwagger - Swagger 2.0 implementation for go
go-fastapi - Create an API and get Swagger definition for free
chi - lightweight, idiomatic and composable router for building Go HTTP services
swag - Simple go wrapper to create swagger compatible APIs
oapi-codegen - Generate Go client and server boilerplate from OpenAPI 3 specifications
Ginrpc - gin auto binding,grpc, and annotated route,gin 注解路由, grpc,自动参数绑定工具
Gin - Gin is a HTTP web framework written in Go (Golang). It features a Martini-like API with much better performance -- up to 40 times faster. If you need smashing performance, get yourself some Gin.
gin-vue-admin - 🚀Vite+Vue3+Gin的开发基础平台,支持TS和JS混用。它集成了JWT鉴权、权限管理、动态路由、显隐可控组件、分页封装、多点登录拦截、资源权限、上传下载、代码生成器、表单生成器和可配置的导入导出等开发必备功能。
swagger2markup - A Swagger to AsciiDoc or Markdown converter to simplify the generation of an up-to-date RESTful API documentation by combining documentation that’s been hand-written with auto-generated API documentation.
gin-timeout - Timeout Middleware for Gin framework
openapi-generator - OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)