昂首阔步如何添加带有说明的标签？

Question

基本上，当我手动编写yaml文件时，我总是可以只定义一个tags:部分，然后依次用-name:和description:定义我的标签。有没有办法在我的大刀阔斧的注释中定义这些内容，以便生成器将它们提取出来？

谢谢

Answer 1

目前，您可以使用变通办法进行调整 那就是用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