openapi

type Api struct {
	Name         string  `json:"name"`         //接口地址
	Summary      string  `json:"summary"`      //名称
	Description  string  `json:"description"`  //描述
	RequestPath  string  `json:"request_path"` //自定义路径
	Point        string  `json:"point"`        //接口结构体对象名称
	Group        string  `json:"group"`        //接口结构体名称
	HttpMethod   string  `json:"method"`       //接口http方法
	Annotate     string  `json:"annotate"`     //注释
	Path         string  `json:"path"`         //文件地址
	Auth         string  `json:"auth"`         //授权方式
	AuthTo       string  `json:"authTo"`       //授权方式
	ResponseType string  `json:"responseType"` //返回类型
	Params       *Struct `json:"params"`       //参数 string为路径 Parameter为对象
	Response     *Struct `json:"response"`     //返回结构体
	// contains filtered or unexported fields
}

type ApiPathsMap map[string]map[string]Method

type BaseType []string

type Components struct {
	Schemas map[string]Property `json:"schemas,omitempty"`

	Responses map[string]Response `json:"responses,omitempty"`

	Parameters []Parameter `json:"parameters,omitempty"`

	RequestBodies map[string]RequestBody `json:"requestBodies,omitempty"`

	Headers map[string]Header `json:"headers,omitempty"`

	SecuritySchemes map[string]*SecurityScheme `json:"securitySchemes,omitempty"`
}

type Config struct {
	Web map[string]struct {
		Prefix string `yaml:"prefix"`
	} `yaml:"web"`
}

type Contact struct {
	Name  string `json:"name,omitempty"`
	Url   string `json:"url,omitempty"`
	Email string `json:"email,omitempty"`
}

type Content struct {
	Type   string   `json:"type,omitempty"`
	Schema Property `json:"schema,omitempty"`
}

type CreatePackageOpt struct {
	NeedApi    bool
	NeedMethod bool
}

type ExternalDocs struct {
	Description string `json:"description,omitempty"`
	Url         string `json:"url,omitempty"`
}

type Field struct {
	Name      string  `json:"name"`      //名称
	Type      string  `json:"type"`      //类型
	Tag       string  `json:"tag"`       //tag
	In        string  `json:"in"`        //存在类型 path 路径 json json对象内
	ParamName string  `json:"paramName"` //参数名
	Validate  string  `json:"validate"`  //验证
	Pkg       string  `json:"Pkg"`       //包名 类型为结构体时
	PkgPath   string  `json:"pkgPath"`   //包路径 类型为结构体时
	Comment   string  `json:"comment"`   //注释
	Array     bool    `json:"array"`     //是否数组
	Ptr       bool    `json:"ptr"`       //是否指针
	MapInfo   MapInfo `json:"mapInfo"`   //map类型键值信息
	Struct    *Struct `json:"struct"`    //是结构体时
}

type Fields []Field

type Flow struct {
	AuthorizationUrl string            `json:"authorizationUrl,omitempty"`
	TokenUrl         string            `json:"tokenUrl,omitempty"`
	Scope            map[string]string `json:"scope,omitempty"`
}

type Header struct {
	Description string   `json:"description,omitempty"`
	Schema      Property `json:"schema,omitempty"`
}

type Info struct {
	Title          string   `json:"title,omitempty"`
	Description    string   `json:"description,omitempty"`
	Version        string   `json:"version,omitempty"`
	TermsOfService string   `json:"termsOfService,omitempty"`
	Contact        *Contact `json:"contact,omitempty"`
	License        *License `json:"license,omitempty"`
}

type License struct {
	Name string `json:"name,omitempty"`
	Url  string `json:"url,omitempty"`
}

type MapField struct {
	Type    string  `json:"type"`    //类型
	Pkg     string  `json:"Pkg"`     //包名 类型为结构体时
	PkgPath string  `json:"pkgPath"` //包路径 类型为结构体时
	Struct  *Struct `json:"struct"`  //是结构体时
}

type MapInfo struct {
	Key   MapField `json:"key"`
	Value MapField `json:"value"`
}

type Method struct {
	Tags        []string              `json:"tags,omitempty"`
	Summary     string                `json:"summary,omitempty"`
	Description string                `json:"description,omitempty"`
	OperationId string                `json:"operationId,omitempty"`
	Parameters  []Parameter           `json:"parameters,omitempty"`
	RequestBody RequestBody           `json:"requestBody,omitempty"`
	Responses   map[string]Response   `json:"responses,omitempty"`
	Security    []map[string][]string `json:"security,omitempty"`
	// contains filtered or unexported fields
}

type MethodMap struct {
	Idx   int
	Paths []string
}

type OpenAPI struct {
	Openapi    string      `json:"openapi,omitempty"`
	Info       Info        `json:"info,omitempty"`
	Servers    []Server    `json:"servers,omitempty"`
	Tags       []Tag       `json:"tags,omitempty"`
	Paths      ApiPathsMap `json:"paths,omitempty"`
	Components Components  `json:"components,omitempty"`
}

type Package struct {
	Name    string             //包名
	Path    string             //包路径
	ModPath string             //模块路径
	Structs map[string]*Struct //所有结构体信息
	// contains filtered or unexported fields
}

type Packages []Package

type Parameter struct {
	Name            string   `json:"name,omitempty"`
	In              string   `json:"in,omitempty"`
	Description     string   `json:"description,omitempty"`
	Required        bool     `json:"required,omitempty"`
	AllowEmptyValue bool     `json:"allowEmptyValue,omitempty"`
	Deprecated      bool     `json:"deprecated,omitempty"`
	Schema          Property `json:"schema,omitempty"`
	Style           string   `json:"style,omitempty"`
}

type Property struct {
	Name        string `json:"-"`
	Type        string `json:"type,omitempty"`
	Description string `json:"description,omitempty"`
	Format      string `json:"format,omitempty"`
	Ref         string `json:"$ref,omitempty"`

	Required   []string            `json:"required,omitempty"`
	Items      *Property           `json:"items,omitempty"` //数组
	File       *Property           `json:"file,omitempty"`
	Properties map[string]Property `json:"properties,omitempty"`
	Enum       []string            `json:"enum,omitempty"`
	// contains filtered or unexported fields
}

type RequestBody struct {
	Description string             `json:"description,omitempty"`
	Required    bool               `json:"required,omitempty"`
	Content     map[string]Content `json:"content,omitempty"`
	Ref         string             `json:"$ref,omitempty"`
}

type Response struct {
	Description string             `json:"description,omitempty"`
	Content     map[string]Content `json:"content,omitempty"`
	Headers     map[string]Header  `json:"headers,omitempty"`
}

type SecurityScheme struct {
	Type         string            `json:"type,omitempty"`
	Scheme       string            `json:"scheme,omitempty"`
	BearerFormat string            `json:"bearerFormat,omitempty"`
	Description  string            `json:"description,omitempty"`
	In           string            `json:"in,omitempty"`
	Flows        []map[string]Flow `json:"flows,omitempty"`
}

type Server struct {
	Url         string `json:"url,omitempty"`
	Description string `json:"description,omitempty"`
}

type Struct struct {
	Name      string            `json:"name"`      //名称
	Des       string            `json:"des"`       //描述
	Type      string            `json:"type"`      //结构体类型
	Field     string            `json:"field"`     //所需字段 有时可能需要的是结构体中的字段 如：rsp.List
	Fields    Fields            `json:"fields"`    //字段
	MethodMap *MethodMap        `json:"methodMap"` //map[参数位置][]链路 方法的返回值类型查找
	Imports   map[string]string //包下所有导入的包信息
	Methods   []StructMethod    `json:"methods"` //方法列表 包括接口的方法
	Api       []Api             //所有API接口信息
	Pkg       *Package
}

type StructMethod struct {
	Name    string  //名称
	Pkg     string  //包名
	PkgPath string  //包路径
	Args    []Field //参数
	Returns []Field //返回值
}

type Tag struct {
	Name         string        `json:"name,omitempty"`
	Description  string        `json:"description,omitempty"`
	ExternalDocs *ExternalDocs `json:"externalDocs,omitempty"`
}