gendoc

package

v0.6.1 Latest Latest Go to latest Published: Sep 29, 2016 License: Apache-2.0 Imports: 10 Imported by: 0

Details

Package gendoc generates documentation for REST APIs.

View Source

const (
	TypeArray  = "array"
	TypeBool   = "boolean"
	TypeFloat  = "float"
	TypeInt    = "integer"
	TypeObject = "object"
	TypeString = "string"
)

View Source

const CodeDefault = 0

This section is empty.

This section is empty.

type Document struct {
	Title       string
	Description string
	Version     string
	Paths       []Path
	Models      []Schema
}

func ParseGoogleAPI(r io.Reader) (Document, error)

func (doc Document) MarshalMarkdown() ([]byte, error)

type Parameter struct {
	Name        string
	LocatedIn   string
	Description string
	Required    bool
	Type        string
}

type Path struct {
	Method      string
	Path        string
	Summary     string
	Description string
	Parameters  []Parameter
	Responses   []Response
}

type Response struct {
	Code        int // 0 means "Default"
	Description string
	Type        string
}

type Schema struct {
	Name        string
	Type        string
	Description string
	Children    []Schema
	Ref         string
}