spec

type Annotation struct {
	Properties map[string]string
}

type ApiSpec struct {
	Info    Info
	Syntax  ApiSyntax
	Imports []Import
	Types   []Type
	Service Service
}

type ApiSyntax struct {
	Version string
}

type ArrayType struct {
	RawName string
	Value   Type
}

type AtDoc struct {
	Properties map[string]string
	Text       string
}

type DefineStruct struct {
	RawName string
	Members []Member
	Docs    Doc
}

type Doc []string

type Group struct {
	Annotation Annotation
	Routes     []Route
}

type Import struct {
	Value string
}

type Info struct {
	// Deprecated: use Properties instead
	Title string
	// Deprecated: use Properties instead
	Desc string
	// Deprecated: use Properties instead
	Version string
	// Deprecated: use Properties instead
	Author string
	// Deprecated: use Properties instead
	Email      string
	Properties map[string]string
}

type InterfaceType struct {
	RawName string
}

type MapType struct {
	RawName string
	// only support the PrimitiveType
	Key string
	// it can be asserted as PrimitiveType: int、bool、
	// PointerType: *string、*User、
	// MapType: map[${PrimitiveType}]interface、
	// ArrayType:[]int、[]User、[]*User
	// InterfaceType: interface{}
	// Type
	Value Type
}

type Member struct {
	Name string
	// 数据类型字面值，如：string、map[int]string、[]int64、[]*User
	Type    Type
	Tag     string
	Comment string
	// 成员头顶注释说明
	Docs     Doc
	IsInline bool
}

type PointerType struct {
	RawName string
	Type    Type
}

type PrimitiveType struct {
	RawName string
}

type Route struct {
	Annotation   Annotation
	Method       string
	Path         string
	RequestType  Type
	ResponseType Type
	Docs         Doc
	Handler      string
	AtDoc        AtDoc
}

type Service struct {
	Name   string
	Groups []Group
}

type Tag struct {
	// Key is the tag key, such as json, xml, etc..
	// i.e: `json:"foo,omitempty". Here key is: "json"
	Key string

	// Name is a part of the value
	// i.e: `json:"foo,omitempty". Here name is: "foo"
	Name string

	// Options is a part of the value. It contains a slice of tag options i.e:
	// `json:"foo,omitempty". Here options is: ["omitempty"]
	Options []string
}

type Tags struct {
	// contains filtered or unexported fields
}

type Type interface {
	Name() string
}