handlers

Documentation

Overview

Package handlers contains the full set of handler functions and routes supported by the web api.

Index

• func APIMux(cfg APIMuxConfig) *web.App
• func DebugMux(build string, log *zap.SugaredLogger) http.Handler
• func DebugStandardLibraryMux() *http.ServeMux
• type APIMuxConfig

Functions

func APIMux

func APIMux(cfg APIMuxConfig) *web.App

APIMux constructs an http.Handler with all application routes defined.

func DebugMux

func DebugMux(build string, log *zap.SugaredLogger) http.Handler

DebugMux registers all the debug standard library routes and then custom debug application routes for the service. This bypassing the use of the DefaultServerMux. Using the DefaultServerMux would be a security risk since a dependency could inject a handler into our service without us knowing it.

func DebugStandardLibraryMux

func DebugStandardLibraryMux() *http.ServeMux

DebugStandardLibraryMux registers all the debug routes from the standard library into a new mux bypassing the use of the DefaultServerMux. Using the DefaultServerMux would be a security risk since a dependency could inject a handler into our service without us knowing it.

Types

type APIMuxConfig

type APIMuxConfig struct {
	Shutdown chan os.Signal
	Log      *zap.SugaredLogger
	Auth     *auth.Auth
}

APIMuxConfig contains all the mandatory systems required by handlers.