CODEWITHSUNDEEP
goswaggerswagger-2.0
user6407048
user6407048

Reputation: 181

Generating Swagger spec with golang comments

I am trying to create documentation for my REST API written in golang using Swagger. I have been following this guide: https://goswagger.io/generate/spec.html to do so and have been able to create the json file from my comments in my main file, however I do not know how to create the .yaml file that would translate to the actual swagger spec. I have followed the instructions on the page and included the //go:generate swagger generate spec in my main file. Anyone know how to create the .yaml file?

Upvotes: 7

Views: 12847

Answers (2)

Camila Macedo
Camila Macedo

Reputation: 925

Yes, you can create a YAML file. Following an example. 

swagger generate spec -m -o ../../api/swagger.yaml

Also, feel free to check the Blog Post.

Upvotes: 3

Casual Jim
Casual Jim

Reputation: 1179

The generated spec would be json not yaml at this stage, not saying it can't be made to do yaml but currently it only generates json.

you can annotate your main package with: //go:generate swagger generate spec -o swagger.json

then you can generate the spec with: go generate when you are in folder of the main package. If your main package is not your project root but something like $project_root/cmd/my-server then you can run go generate ./cmd/my-server from the project root.

Upvotes: 4

Related Questions