parser

type Definition ¶

type Definition struct {
	Name        string
	Description string
	Operations  []Operation
}

The Definition provides the high-level information about all operations of the service

func NewDefinition(name string, description string, operations []Operation) *Definition

type OpenApiParser ¶

type OpenApiParser struct{}

The OpenApiParser parses OpenAPI (2.x and 3.x) specifications. It creates the Definition structure with all the information about the available operations and their parameters for the given service specification.

func NewOpenApiParser() *OpenApiParser

func (p OpenApiParser) Parse(name string, data []byte) (*Definition, error)

type Operation ¶

type Operation struct {
	Name        string
	Summary     string
	Description string
	Method      string
	BaseUri     url.URL
	Route       string
	ContentType string
	Parameters  []Parameter
	Plugin      plugin.CommandPlugin
	Hidden      bool
	Category    *OperationCategory
}

The Operation is the definition of a route which can be called by the CLI.

It holds all the information needed to make the call, like HTTP method, Route, Parameters, etc...

func NewOperation(name string, summary string, description string, method string, baseUri url.URL, route string, contentType string, parameters []Parameter, plugin plugin.CommandPlugin, hidden bool, category *OperationCategory) *Operation

type OperationCategory ¶

type OperationCategory struct {
	Name        string
	Description string
}

OperationCategory allows grouping multiple operations under a common resource.

func NewOperationCategory(name string, description string) *OperationCategory

type Parameter ¶

type Parameter struct {
	Name          string
	Type          string
	Description   string
	In            string
	FieldName     string
	Required      bool
	DefaultValue  interface{}
	AllowedValues []interface{}
	Parameters    []Parameter
}

Parameter contains all the information about a parameter for an operation.

func NewParameter(name string, t string, description string, in string, fieldName string, required bool, defaultValue interface{}, allowedValues []interface{}, parameters []Parameter) *Parameter

func (p Parameter) IsArray() bool

type Parser ¶

type Parser interface {
	Parse(name string, data []byte) (*Definition, error)
}

The Parser interface provides an abstraction for parsing the service definition files. It returns a structured Definition document with all the operations and parameters of the service.