model

type Operation struct {
	Comment     string
	OperationID string
	APIMethodUC string // method upper case
	APIMethodLC string // method lower case
	APIPath     string
	Parameters  []Parameter

	Tags         []string
	HasAPIDocURL bool
	APIDocURL    string // doc's URL
}

type PackageInfo struct {
	Name        string `json:"name" short:"n" long:"pkg-name" description:"sdk name, required, default from swagger's info.x-package-name"`
	Version     string `json:"version" short:"v" long:"pkg-version" description:"sdk version, required, default from swagger's version"`
	Description string `json:"description" long:"pkg-description" description:"sdk description, default from swagger's info.description"`
	Author      struct {
		Name  string `json:"name" long:"pkg-author-name" description:"sdk author name, default from swagger's info.contact.name"`
		Email string `json:"email,omitempty" long:"pkg-author-email" description:"sdk author email, default from swagger's info.contact.email"`
	} `json:"author"`
	Homepage string `json:"homepage,omitempty" long:"pkg-homepage" description:"sdk homepage, default from swagger's info.x-homepage"`
	License  string `json:"license,omitempty" long:"pkg-license" description:"sdk license, default from swagger's info.license"`
}

type PackageJSON struct {
	PackageInfo
	Main     string          `json:"main"`
	Module   string          `json:"module"`
	Scripts  json.RawMessage `json:"scripts"`
	Keywords []string        `json:"keywords"`
}

type Parameter struct {
	Name    string
	Names   []ParameterName // with normalized name, in camel case
	Comment string
	Type    ParameterType
	TypeIs  struct {
		Header, Path, Query, Body, FormData bool
	}
}

type ParameterName struct {
	Swagger, JS string
}

type ParameterType string

type Swagger struct {
	GenConf SwaggerGenConf // config options

	PkgJSON PackageJSON // lib's package.json

	UI       SwaggerUI
	Info     SwaggerInfo
	FileType SwaggerFileType

	Operations []Operation

	RawContent []byte
}

type SwaggerFileType int

type SwaggerGenConf struct {
	CommonJS        bool // set to true to output cjs, otherwise ejs
	UrlRefInComment bool // set swagger UI deep link url in js comment, like https://petstore.swagger.io/#/pet/getPetById
}

type SwaggerInfo struct {
	Description string `json:"description" yaml:"description"`
	Version     string `json:"version" yaml:"version"`
	Title       string `json:"title" yaml:"title"`
	Contact     struct {
		Name  string `json:"name" yaml:"name"` // ext: contact's name
		Email string `json:"email" yaml:"email"`
	} `json:"contact" yaml:"contact"`
	License struct {
		Name string `json:"name" yaml:"name"`
	} `json:"license" yaml:"license"`
	Homepage    string `json:"x-homepage" yaml:"x-homepage"`       // ext: swagger UI homepage
	PackageName string `json:"x-package-name" yaml:"package-name"` // ext: js package name
}

type SwaggerUI struct {
	Version string
	CDN     SwaggerUICdn
}

type SwaggerUICdn string