http

Documentation

Index

• Constants
• Variables
• func Parse(r *http.Request, root *cmds.Command) (cmds.Request, error)
• type Client
  • func NewClient(address string) Client
• type Handler
  • func NewHandler(ctx context.Context, root *cmds.Command, cfg *ServerConfig) *Handler
  • func (i Handler) ServeHTTP(w http.ResponseWriter, r *http.Request)
• type MultiFileReader
  • func NewMultiFileReader(file files.File, form bool) *MultiFileReader
  • func (mfr *MultiFileReader) Boundary() string
  • func (mfr *MultiFileReader) Read(buf []byte) (written int, err error)
• type ServerConfig

Constants

const (
	ApiUrlFormat = "http://%s%s/%s?%s"
	ApiPath      = "/api/v0" // TODO: make configurable
)

const (
	ACAOrigin      = "Access-Control-Allow-Origin"
	ACAMethods     = "Access-Control-Allow-Methods"
	ACACredentials = "Access-Control-Allow-Credentials"
)

const (
	StreamErrHeader = "X-Stream-Error"
)

Variables

var ErrNotFound = errors.New("404 page not found")

Functions

func Parse

func Parse(r *http.Request, root *cmds.Command) (cmds.Request, error)

Parse parses the data in a http.Request and returns a command Request object

Types

type Client

type Client interface {
	Send(req cmds.Request) (cmds.Response, error)
}

Client is the commands HTTP client interface.

func NewClient

func NewClient(address string) Client

type Handler

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

The Handler struct is funny because we want to wrap our internal handler with CORS while keeping our fields.

func NewHandler

func NewHandler(ctx context.Context, root *cmds.Command, cfg *ServerConfig) *Handler

func (Handler) ServeHTTP

func (i Handler) ServeHTTP(w http.ResponseWriter, r *http.Request)

type MultiFileReader

type MultiFileReader struct {
	io.Reader
	// contains filtered or unexported fields
}

MultiFileReader reads from a `commands.File` (which can be a directory of files or a regular file) as HTTP multipart encoded data.

func NewMultiFileReader

func NewMultiFileReader(file files.File, form bool) *MultiFileReader

NewMultiFileReader constructs a MultiFileReader. `file` can be any `commands.File`. If `form` is set to true, the multipart data will have a Content-Type of 'multipart/form-data', if `form` is false, the Content-Type will be 'multipart/mixed'.

func (*MultiFileReader) Boundary

func (mfr *MultiFileReader) Boundary() string

Boundary returns the boundary string to be used to separate files in the multipart data

func (*MultiFileReader) Read

func (mfr *MultiFileReader) Read(buf []byte) (written int, err error)

type ServerConfig

type ServerConfig struct {
	// Headers is an optional map of headers that is written out.
	Headers map[string][]string

	// CORSOpts is a set of options for CORS headers.
	CORSOpts *cors.Options
}