proto

package
v0.0.0-...-d88c8b5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 9, 2021 License: Apache-2.0 Imports: 5 Imported by: 0

Documentation

Overview

Package proto is a collection of libraries for parsing and indexing the type definitions. The openapi spec contains the object model definitions and extensions metadata.

Index

Constants

View Source
const (
	Integer = "integer"
	Number  = "number"
	String  = "string"
	Boolean = "boolean"
)

Defines openapi types.

Variables

This section is empty.

Functions

func VendorExtensionToMap

func VendorExtensionToMap(e []*openapi_v2.NamedAny) map[string]interface{}

VendorExtensionToMap converts openapi VendorExtension to a map.

Types

type Arbitrary

type Arbitrary struct {
	BaseSchema
}

Arbitrary is a value of any type (primitive, object or array)

func (*Arbitrary) Accept

func (a *Arbitrary) Accept(v SchemaVisitor)

func (*Arbitrary) GetName

func (a *Arbitrary) GetName() string

type Array

type Array struct {
	BaseSchema

	SubType Schema
}

Array must have all its element of the same `SubType`.

func (*Array) Accept

func (a *Array) Accept(v SchemaVisitor)

func (*Array) GetName

func (a *Array) GetName() string

type BaseSchema

type BaseSchema struct {
	Description string
	Extensions  map[string]interface{}
	Default     interface{}

	Path Path
}

BaseSchema holds data used by each types of schema.

func (*BaseSchema) GetDefault

func (b *BaseSchema) GetDefault() interface{}

func (*BaseSchema) GetDescription

func (b *BaseSchema) GetDescription() string

func (*BaseSchema) GetExtensions

func (b *BaseSchema) GetExtensions() map[string]interface{}

func (*BaseSchema) GetPath

func (b *BaseSchema) GetPath() *Path

type Definitions

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

Definitions is an implementation of `Models`. It looks for models in an openapi Schema.

func (*Definitions) ListModels

func (d *Definitions) ListModels() []string

func (*Definitions) LookupModel

func (d *Definitions) LookupModel(model string) Schema

LookupModel is public through the interface of Models. It returns a visitable schema from the given model name.

func (*Definitions) ParseSchema

func (d *Definitions) ParseSchema(s *openapi_v2.Schema, path *Path) (Schema, error)

ParseSchema creates a walkable Schema from an openapi schema. While this function is public, it doesn't leak through the interface.

type Kind

type Kind struct {
	BaseSchema

	// Lists names of required fields.
	RequiredFields []string
	// Maps field names to types.
	Fields map[string]Schema
	// FieldOrder reports the canonical order for the fields.
	FieldOrder []string
}

Kind is a complex object. It can have multiple different subtypes for each field, as defined in the `Fields` field. Mandatory fields are listed in `RequiredFields`. The key of the object is always of type `string`.

func (*Kind) Accept

func (k *Kind) Accept(v SchemaVisitor)

func (*Kind) GetName

func (k *Kind) GetName() string

func (*Kind) IsRequired

func (k *Kind) IsRequired(field string) bool

IsRequired returns true if `field` is a required field for this type.

func (*Kind) Keys

func (k *Kind) Keys() []string

Keys returns a alphabetically sorted list of keys.

type Map

type Map struct {
	BaseSchema

	SubType Schema
}

Map is an object who values must all be of the same `SubType`. The key of the object is always of type `string`.

func (*Map) Accept

func (m *Map) Accept(v SchemaVisitor)

func (*Map) GetName

func (m *Map) GetName() string

type Models

type Models interface {
	LookupModel(string) Schema
	ListModels() []string
}

Models interface describe a model provider. They can give you the schema for a specific model.

func NewOpenAPIData

func NewOpenAPIData(doc *openapi_v2.Document) (Models, error)

NewOpenAPIData creates a new `Models` out of the openapi document.

type Path

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

Path helps us keep track of type paths

func NewPath

func NewPath(key string) Path

func (*Path) ArrayPath

func (p *Path) ArrayPath(i int) Path

ArrayPath appends an array index and creates a new path

func (*Path) FieldPath

func (p *Path) FieldPath(field string) Path

FieldPath appends a field name and creates a new path

func (*Path) Get

func (p *Path) Get() []string

func (*Path) Len

func (p *Path) Len() int

func (*Path) String

func (p *Path) String() string

type Primitive

type Primitive struct {
	BaseSchema

	// Type of a primitive must be one of: integer, number, string, boolean.
	Type   string
	Format string
}

Primitive is a literal. There can be multiple types of primitives, and this subtype can be visited through the `subType` field.

func (*Primitive) Accept

func (p *Primitive) Accept(v SchemaVisitor)

func (*Primitive) GetName

func (p *Primitive) GetName() string

type Ref

type Ref struct {
	BaseSchema
	// contains filtered or unexported fields
}

func (*Ref) Accept

func (r *Ref) Accept(v SchemaVisitor)

func (*Ref) GetName

func (r *Ref) GetName() string

func (*Ref) Reference

func (r *Ref) Reference() string

func (*Ref) SubSchema

func (r *Ref) SubSchema() Schema

type Reference

type Reference interface {
	Schema

	Reference() string
	SubSchema() Schema
}

Reference implementation depends on the type of document.

type Schema

type Schema interface {
	// Giving a visitor here will let you visit the actual type.
	Accept(SchemaVisitor)

	// Pretty print the name of the type.
	GetName() string
	// Describes how to access this field.
	GetPath() *Path
	// Describes the field.
	GetDescription() string
	// Default for that schema.
	GetDefault() interface{}
	// Returns type extensions.
	GetExtensions() map[string]interface{}
}

Schema is the base definition of an openapi type.

type SchemaVisitor

type SchemaVisitor interface {
	VisitArray(*Array)
	VisitMap(*Map)
	VisitPrimitive(*Primitive)
	VisitKind(*Kind)
	VisitReference(Reference)
}

SchemaVisitor is an interface that you need to implement if you want to "visit" an openapi schema. A dispatch on the Schema type will call the appropriate function based on its actual type: - Array is a list of one and only one given subtype - Map is a map of string to one and only one given subtype - Primitive can be string, integer, number and boolean. - Kind is an object with specific fields mapping to specific types. - Reference is a link to another definition.

type SchemaVisitorArbitrary

type SchemaVisitorArbitrary interface {
	SchemaVisitor
	VisitArbitrary(*Arbitrary)
}

SchemaVisitorArbitrary is an additional visitor interface which handles arbitrary types. For backwards compatibility, it's a separate interface which is checked for at runtime.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL