genopenapi

Documentation

Overview

Package genopenapi provides a code generator for OpenAPI v2.

Index

• func AddErrorDefs(reg *descriptor.Registry) error
• func LookupNamingStrategy(strategyName string) func([]string) map[string]string
• func New(reg *descriptor.Registry, format Format) gen.Generator
• type ContentEncoder
• type Format
  • func (f Format) NewEncoder(w io.Writer) (ContentEncoder, error)
  • func (f Format) Validate() error
• type GeneratorOptions
• type RawExample
  • func (m RawExample) MarshalJSON() ([]byte, error)
  • func (e RawExample) MarshalYAML() (interface{}, error)
  • func (m *RawExample) UnmarshalJSON(data []byte) error

Functions

func AddErrorDefs

func AddErrorDefs(reg *descriptor.Registry) error

AddErrorDefs Adds google.rpc.Status and google.protobuf.Any to registry (used for error-related API responses)

func LookupNamingStrategy

func LookupNamingStrategy(strategyName string) func([]string) map[string]string

LookupNamingStrategy looks up the given naming strategy and returns the naming strategy function for it. The naming strategy function takes in the list of all fully-qualified proto message names, and returns a mapping from fully-qualified name to OpenAPI name.

func New

func New(reg *descriptor.Registry, format Format) gen.Generator

New returns a new generator which generates grpc gateway files.

Types

type ContentEncoder

type ContentEncoder interface {
	Encode(v interface{}) (err error)
}

type Format

type Format string

const (
	FormatJSON Format = "json"
	FormatYAML Format = "yaml"
)

func (Format) NewEncoder

func (f Format) NewEncoder(w io.Writer) (ContentEncoder, error)

func (Format) Validate

func (f Format) Validate() error

type GeneratorOptions

type GeneratorOptions struct {
	Registry       *descriptor.Registry
	RecursiveDepth int
}

type RawExample

type RawExample json.RawMessage

func (RawExample) MarshalJSON

func (m RawExample) MarshalJSON() ([]byte, error)

func (RawExample) MarshalYAML

func (e RawExample) MarshalYAML() (interface{}, error)

MarshalYAML implements yaml.Marshaler interface.

It converts RawExample to one of yaml-supported types and returns it.

From yaml.Marshaler docs: The Marshaler interface may be implemented by types to customize their behavior when being marshaled into a YAML document. The returned value is marshaled in place of the original value implementing Marshaler.

func (*RawExample) UnmarshalJSON

func (m *RawExample) UnmarshalJSON(data []byte) error