大摇大摆地如何添加带有描述的标签?

Question

基本上，当我手动编写yaml文件时，我总是可以定义一个tags:部分，然后用-name:和description:逐个定义我的标签。有没有办法在我的大摇大摆的评论中定义这些，以便生成器拾取它们？

谢谢

Answer 1

现在，您可以使用解决方法进行 go-swagger。 也就是说，在 json 中指定一个带有标签的输入文件，并将其传递给您的 go generate 命令。

即，

//go:generate swagger generate spec --input tags.json -o swagger.json

其中 tags.json 将包含标签对象的数组，

即，

{
"tags": [
{
"name":"YourRoute1",
"description":"Your Route 1 Description"
},
{
"name":"YourRoute2",
"description":"Your Route 2 Description"
}
]
}

这将生成一个包含 tags.json 文件的组合输出到您的输出 swagger.json