go-swagger - go-swagger 如何添加带有描述的标签？

Question

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

谢谢

Answer 1

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

IE，

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

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

IE，

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

这将产生与您的 tags.json 文件的组合输出到您的输出 swagger.json