What tools or instruments have you used for automatic Swagger documentation generation?

For automatic Swagger documentation generation in Go projects, the package swaggo/swag is often used. It allows generating an OpenAPI (Swagger) specification from comments in the code.

Example of usage:

1. Install the tool:

go install github.com/swaggo/swag/cmd/swag@latest

2. Add comments to your HTTP handlers, for example:

// @Summary Get user
// @Description Get user by ID
// @Tags users
// @Accept json
// @Produce json
// @Param id path int true "User ID"
// @Success 200 {object} User
// @Router /users/{id} [get]
func GetUser(c *gin.Context) {
    // implementation
}

3. Generate documentation with the command:

swag init

4. Connect the generated files to your HTTP server to display the Swagger UI.

Tools like go-swagger and echo-swagger are also popular for the Echo framework.