swagger

package
v0.1.0 Latest Latest
Warning

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

Go to latest
Published: Oct 31, 2016 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func BaseParamToStringCode

func BaseParamToStringCode() string

BaseParamToStringCode returns the code for a function that joins a string array by a known format (csv, ssv, tsv, pipes).

func BaseStringToTypeCode

func BaseStringToTypeCode() string

BaseStringToTypeCode is the helper code from base string to type

func Capitalize

func Capitalize(input string) string

Capitalize the first character of a string.

func CodeToTypeMap

func CodeToTypeMap(op *spec.Operation) map[int]string

CodeToTypeMap returns a map from return status code to its corresponding type

func DefaultAsString

func DefaultAsString(param spec.Parameter) string

DefaultAsString returns the default value as a string. We convert it into a string so it's easier to insert into the generated code and it doesn't make this logic really any different.

func ImportStatements

func ImportStatements(imports []string) string

ImportStatements takes a list of import strings and converts them to a formatted imports

func InitCustomFormats

func InitCustomFormats()

InitCustomFormats adds wag's custom formats to the global go-openapi/strfmt Default registry.

func Interface

func Interface(op *spec.Operation) string

Interface returns the interface for an operation

func InterfaceComment

func InterfaceComment(method, path string, op *spec.Operation) string

InterfaceComment returns the comment for the interface for the operation

func NoSuccessType

func NoSuccessType(op *spec.Operation) bool

NoSuccessType returns true if the operation has no-success response type. This includes either no 200-399 response code or a 200-399 response code without a schema.

func OutputType

func OutputType(op *spec.Operation, statusCode int) (string, bool)

OutputType returns the output type for a given status code of an operation and whether it is a pointer in the interface.

func ParamToStringCode

func ParamToStringCode(param spec.Parameter) string

ParamToStringCode returns a function that converts a Parameter into the code to convert it into a string (for serialization). For example, a integer named 'Size' becomes `strconv.FormatInt(i.Size, 10)`

func ParamToType

func ParamToType(param spec.Parameter, withPointer bool) (string, error)

ParamToType converts a parameter into its Go type. If withPointer is true it will make the variable a pointer if it's not required and not an array type

func ParamToValidationCode

func ParamToValidationCode(param spec.Parameter) ([]string, error)

ParamToValidationCode takes in a param and returns a list of parameter validation functions, each of which have a single return value, error

func PathItemOperations

func PathItemOperations(item spec.PathItem) map[string]*spec.Operation

PathItemOperations converts a spec.PathItem to a map from HTTP operation (e.g., "GET") to spec.Operation.

func SingleSchemaedBodyParameter

func SingleSchemaedBodyParameter(op *spec.Operation) (bool, string)

SingleSchemaedBodyParameter returns true if the operation has a single, schema'd body input. It also returns the name of the model (without "models.").

func SortedOperationsKeys

func SortedOperationsKeys(m map[string]*spec.Operation) []string

SortedOperationsKeys sorts the keys of a map[string]*spec.Operation.

func SortedPathItemKeys

func SortedPathItemKeys(m map[string]spec.PathItem) []string

SortedPathItemKeys sorts the keys of a map[string]spec.PathItem.

func SortedStatusCodeKeys

func SortedStatusCodeKeys(m map[int]spec.Response) []int

SortedStatusCodeKeys sorts the keys of a map[int]spec.Response.

func StringToTypeCode

func StringToTypeCode(strField string, param spec.Parameter) (string, error)

StringToTypeCode returns the code to convert a string into the type. For example, for an int64 it generates swag.ConvertFloat64(sizeStr). It returns an array because sometimes this takes multiple lines of code

func StructParamName

func StructParamName(param spec.Parameter) string

StructParamName returns the name of the struct as used in the model struct

func TypeFromSchema

func TypeFromSchema(schema *spec.Schema, includeModels bool) (string, error)

TypeFromSchema returns the type of a Swagger schema as a string. If includeModels is true then it returns models.TYPE

func WagPatchDataTypes

func WagPatchDataTypes(paths map[string]spec.PathItem) (map[string]struct{}, error)

WagPatchDataTypes returns a set of all the data types that have x-wag-patch associated with them. These data types should also have a Patch{{Name}} data type created for them.

Types

type Generator

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

Generator handles common code generation operations when generating a file in a Go package.

func (*Generator) Printf

func (g *Generator) Printf(format string, args ...interface{})

Printf writes a formatted string to the buffer.

func (*Generator) Write

func (g *Generator) Write(p []byte) (n int, err error)

Write bytes to the buffer.

func (*Generator) WriteFile

func (g *Generator) WriteFile(path string) error

WriteFile writes the buffer to a gofmt-ed file. The file will be located at $GOPATH/src/{PackageName}/{path}.

Jump to

Keyboard shortcuts

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