go-swagger：swaggogin

gin middleware to automatically generate RESTful API documentation with Swagger 2.0.

Add comments to your API source code, See Declarative Comments Format[1]. Download Swag[2] for Go by using: go get -u github.com/swaggo/swag/cmd/swag

Starting in Go 1.17, installing executables with go get is deprecated. go install may be used instead:

go install github.com/swaggo/swag/cmd/swag@latest Run the Swag[3] at your Go project root path(for instance ~/root/go-project-name), Swag[4] will parse comments and generate required files(docs folder and docs/doc.go) at ~/root/go-project-name/docs. Download gin-swagger[5] by using: go get -u github.com/swaggo/gin-swagger go get -u github.com/swaggo/files

Import following in your code:

import "github.com/swaggo/gin-swagger" // gin-swagger middleware import "github.com/swaggo/files" // swagger embed files

Now assume you have implemented a simple api as followin...