gen

Documentation

Index

• type Elem
  • func (e Elem) NextVar() string
• type ErrNotImplemented
  • func (e *ErrNotImplemented) Error() string
• type ErrUnsupportedContentTypes
  • func (e *ErrUnsupportedContentTypes) Error() string
• type FileSystem
• type Generator
  • func NewGenerator(spec *ogen.Spec, opts Options) (*Generator, error)
  • func (g *Generator) WriteSource(fs FileSystem, pkgName string) error
• type MethodRoute
  • func (m *MethodRoute) Add(r Route) error
• type Options
• type ResponseElem
• type Route
• type RouteNode
  • func (n *RouteNode) Children() []*RouteNode
  • func (n *RouteNode) Head() byte
  • func (n *RouteNode) IsLeaf() bool
  • func (n *RouteNode) IsParam() bool
  • func (n *RouteNode) IsStatic() bool
  • func (n *RouteNode) Operation() *ir.Operation
  • func (n *RouteNode) Param() *ir.Parameter
  • func (n *RouteNode) ParamChildren() (r []*RouteNode)
  • func (n *RouteNode) ParamName() string
  • func (n *RouteNode) Prefix() string
  • func (n *RouteNode) StaticChildren() (r []*RouteNode)
  • func (n *RouteNode) Tails() (r []byte)
• type RouteTree
  • func (t *RouteTree) Walk(cb func(level int, n *RouteNode))
• type Router
  • func (s *Router) Add(r Route) error
• type RouterElem
• type TemplateConfig
  • func (t TemplateConfig) RegexStrings() (r []string)

Types

type Elem

type Elem struct {
	// Sub whether this Elem has parent Elem.
	Sub bool
	// Type is type of this Elem.
	Type *ir.Type
	// Var is decoding/encoding variable Go name (obj) or selector (obj.Field).
	Var string
	// Tag contains info about field tags, if any.
	Tag ir.Tag
	// First whether this field is first.
	First bool
}

Elem variable helper for recursive array or object encoding or decoding.

func (Elem) NextVar

func (e Elem) NextVar() string

NextVar returns name of variable for decoding recursive call.

Needed to make variable names unique.

type ErrNotImplemented

type ErrNotImplemented struct {
	Name string
}

func (*ErrNotImplemented) Error

func (e *ErrNotImplemented) Error() string

type ErrUnsupportedContentTypes

type ErrUnsupportedContentTypes struct {
	ContentTypes []string
}

func (*ErrUnsupportedContentTypes) Error

func (e *ErrUnsupportedContentTypes) Error() string

type FileSystem

type FileSystem interface {
	WriteFile(baseName string, source []byte) error
}

FileSystem represents a directory of generated package.

type Generator

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

func NewGenerator

func NewGenerator(spec *ogen.Spec, opts Options) (*Generator, error)

func (*Generator) WriteSource

func (g *Generator) WriteSource(fs FileSystem, pkgName string) error

WriteSource writes generated definitions to fs.

type MethodRoute

type MethodRoute struct {
	Method string
	Tree   RouteTree
}

MethodRoute is route for one Method.

func (*MethodRoute) Add

func (m *MethodRoute) Add(r Route) error

Add adds route to this tree.

type Options

type Options struct {
	VerboseRoute         bool
	SpecificMethodPath   string
	IgnoreNotImplemented []string
}

type ResponseElem

type ResponseElem struct {
	Response *ir.StatusResponse
	Ptr      bool
}

type Route

type Route struct {
	Method    string        // GET, POST, DELETE
	Operation *ir.Operation // getUserInfo
	Path      string        // /api/v1/user/{name}/info
}

type RouteNode

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

RouteNode is node of Radix tree of routes.

func (*RouteNode) Children

func (n *RouteNode) Children() []*RouteNode

Children returns child nodes.

func (*RouteNode) Head

func (n *RouteNode) Head() byte

Head returns first byte of prefix.

func (*RouteNode) IsLeaf

func (n *RouteNode) IsLeaf() bool

IsLeaf whether node has no children.

func (*RouteNode) IsParam

func (n *RouteNode) IsParam() bool

IsParam whether node is a parameter node.

func (*RouteNode) IsStatic

func (n *RouteNode) IsStatic() bool

IsStatic whether node is not a parameter node.

func (*RouteNode) Operation

func (n *RouteNode) Operation() *ir.Operation

Operation returns associated operation.

func (*RouteNode) Param

func (n *RouteNode) Param() *ir.Parameter

Param returns associated parameter, if any.

May be nil.

func (*RouteNode) ParamChildren

func (n *RouteNode) ParamChildren() (r []*RouteNode)

ParamChildren returns slice of child parameter nodes.

func (*RouteNode) ParamName

func (n *RouteNode) ParamName() string

ParamName returns parameter name, if any.

func (*RouteNode) Prefix

func (n *RouteNode) Prefix() string

Prefix returns common prefix.

func (*RouteNode) StaticChildren

func (n *RouteNode) StaticChildren() (r []*RouteNode)

StaticChildren returns slice of child static nodes.

func (*RouteNode) Tails

func (n *RouteNode) Tails() (r []byte)

Tails returns heads of child nodes.

Used for matching end of parameter node between two static.

type RouteTree

type RouteTree struct {
	Root *RouteNode
}

RouteTree is Radix tree of routes.

func (*RouteTree) Walk

func (t *RouteTree) Walk(cb func(level int, n *RouteNode))

type Router

type Router struct {
	Methods []MethodRoute
	// MaxParametersCount is maximum number of path parameters in one operation.
	MaxParametersCount int
}

Router contains list of routes.

func (*Router) Add

func (s *Router) Add(r Route) error

Add adds new route.

type RouterElem

type RouterElem struct {
	// ParameterIndex is index of parameter of this route part.
	ParameterIndex int
	Route          *RouteNode
}

RouterElem is variable helper for router generation.

type TemplateConfig

type TemplateConfig struct {
	Package    string
	Operations []*ir.Operation
	Types      map[string]*ir.Type
	Interfaces map[string]*ir.Type
	Error      *ir.StatusResponse
	ErrorType  *ir.Type
	Router     Router
}

func (TemplateConfig) RegexStrings

func (t TemplateConfig) RegexStrings() (r []string)

RegexStrings returns slice of all unique regex validators.