api/vendor/github.com/swaggo/swag/cmd/swag/main.go

77 lines
1.8 KiB
Go
Raw Normal View History

2018-12-01 01:59:17 +00:00
package main
import (
"log"
"os"
"github.com/pkg/errors"
"github.com/swaggo/swag"
"github.com/swaggo/swag/gen"
"github.com/urfave/cli"
)
func main() {
app := cli.NewApp()
app.Version = swag.Version
app.Usage = "Automatically generate RESTful API documentation with Swagger 2.0 for Go."
app.Commands = []cli.Command{
{
Name: "init",
Aliases: []string{"i"},
Usage: "Create docs.go",
Action: func(c *cli.Context) error {
2019-05-07 19:42:24 +00:00
searchDir := c.String("dir")
2018-12-01 01:59:17 +00:00
mainAPIFile := c.String("generalInfo")
strategy := c.String("propertyStrategy")
2019-05-07 19:42:24 +00:00
outputDir := c.String("output")
parseVendor := c.Bool("parseVendor")
2018-12-01 01:59:17 +00:00
switch strategy {
case swag.CamelCase, swag.SnakeCase, swag.PascalCase:
default:
return errors.Errorf("not supported %s propertyStrategy", strategy)
}
2019-05-07 19:42:24 +00:00
return gen.New().Build(&gen.Config{
SearchDir: searchDir,
MainAPIFile: mainAPIFile,
PropNamingStrategy: strategy,
OutputDir: outputDir,
ParseVendor: parseVendor,
})
2018-12-01 01:59:17 +00:00
},
Flags: []cli.Flag{
cli.StringFlag{
Name: "generalInfo, g",
Value: "main.go",
Usage: "Go file path in which 'swagger general API Info' is written",
},
cli.StringFlag{
Name: "dir, d",
Value: "./",
Usage: "Directory you want to parse",
},
cli.StringFlag{
Name: "propertyStrategy, p",
Value: "camelcase",
Usage: "Property Naming Strategy like snakecase,camelcase,pascalcase",
},
2019-05-07 19:42:24 +00:00
cli.StringFlag{
Name: "output, o",
Value: "./docs",
Usage: "Output directory for al the generated files(swagger.json, swagger.yaml and doc.go)",
},
cli.BoolFlag{
Name: "parseVendor",
Usage: "Parse go files in 'vendor' folder, disabled by default",
},
2018-12-01 01:59:17 +00:00
},
},
}
err := app.Run(os.Args)
if err != nil {
log.Fatal(err)
}
}