api

Documentation

Index

• func StaticFilePatternReplaceMiddleware(oldnew ...string) func(c *gin.Context)
• type Server
  • func NewServer() *Server
  • func (s *Server) Handler(ctx context.Context) http.Handler
  • func (s *Server) ListenAndServe() error
  • func (s *Server) SetDashboardAPIPathPrefix(dashboardAPIPathPrefix string)
  • func (s *Server) SetDashboardPathPrefix(dashboardPathPrefix string)
  • func (s *Server) SetDashboardSentryDSN(dashboardSentryDSN string)
  • func (s *Server) SetEditorPathPrefix(editorPathPrefix string)
  • func (s *Server) WithAuth(authProvider func(*http.Request) (string, error))
• type StatsOut
  • func Stats(c *gin.Context) (*StatsOut, error)

Functions

func StaticFilePatternReplaceMiddleware

func StaticFilePatternReplaceMiddleware(oldnew ...string) func(c *gin.Context)

StaticFilePatternReplaceMiddleware is a middleware that modifies the response body with a given replace pattern Used inside utask to change response body of static files at flight, to customize path prefixes.

Types

type Server

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

Server wraps the http handler that exposes a REST API to control the task orchestration engine

func NewServer

func NewServer() *Server

NewServer returns a new Server

func (*Server) Handler

func (s *Server) Handler(ctx context.Context) http.Handler

Handler returns the underlying http.Handler of a Server

func (*Server) ListenAndServe

func (s *Server) ListenAndServe() error

ListenAndServe launches an http server and stays blocked until the server is shut down by a system signal

func (*Server) SetDashboardAPIPathPrefix

func (s *Server) SetDashboardAPIPathPrefix(dashboardAPIPathPrefix string)

SetDashboardAPIPathPrefix configures a custom path prefix that UI should use when calling utask API. Required when utask API is exposed behind a ProxyPass and UI need to know the absolute URI to call.

func (*Server) SetDashboardPathPrefix

func (s *Server) SetDashboardPathPrefix(dashboardPathPrefix string)

SetDashboardPathPrefix configures the custom path prefix for dashboard static files hosting. It doesn't change the path used by utask API to serve the files, it's only used inside UI files in order that dashboard can be aware of a ProxyPass configuration.

func (*Server) SetDashboardSentryDSN

func (s *Server) SetDashboardSentryDSN(dashboardSentryDSN string)

SetDashboardSentryDSN configures a Sentry DSN URI to send UI exceptions and failures to.

func (*Server) SetEditorPathPrefix

func (s *Server) SetEditorPathPrefix(editorPathPrefix string)

SetEditorPathPrefix configures a custom path prefix for editor static files hosting. It doesn't change the path used by utask API to serve the files, it's only used inside UI files in order that editor can be aware of a ProxyPass configuration.

func (*Server) WithAuth

func (s *Server) WithAuth(authProvider func(*http.Request) (string, error))

WithAuth configures the Server's auth middleware it receives an authProvider function capable of extracting a caller's identity from an *http.Request the authProvider function also has discretion to deny authorization for a request by returning an error

type StatsOut

type StatsOut struct {
	TaskStates map[string]float64 `json:"task_states"`
}

StatsOut aggregates different business stats: - a map of task states and their count

func Stats

func Stats(c *gin.Context) (*StatsOut, error)

Stats handles the http request to fetch µtask statistics common to all instances