app

Documentation

Index

• type AppInfo
• type AppInformer
• type Application
  • func New(appName, appVersion string) Application
• type Config
• type HandlerDefinition
• type Service
• type ServiceFactory

Types

type AppInfo

type AppInfo struct {
	ConfigPath string
}

AppInfo contains general app information and settings

type AppInformer

type AppInformer func() *AppInfo

type Application

type Application interface {
	RegisterService(name string, cfg any, factory ServiceFactory) error // service name must match the unquoted yaml key format (e.g. [a-zA-Z_]+)
	Run(config any)
}

Application is the main application interface

func New

func New(appName, appVersion string) Application

New creates a new Application instance

type Config

type Config struct {
	HTTP          httpserver.Config `yaml:"http" group:"HTTP endpoint configuration"`
	Sentry        sentry.Config     `yaml:"sentry" group:"Sentry configuration"`
	ShutdownDelay time.Duration     `yaml:"shutdown_delay" description:"Time to wait before shutting down"`
	LogLevel      string            `yaml:"log_level" description:"Log level in production mode" default:"info" choices:"debug,info,warn,error,dpanic,panic,fatal"`
	Production    bool              `yaml:"production" description:"Production mode"`
}

type HandlerDefinition

type HandlerDefinition struct {
	Endpoint string // used as "method" label for the `servicename_request_latency{method="endpoint"}` metric
	Method   string // GET, POST, etc.
	Path     string // URL path (Gorilla URL vars allowed)
	Func     httpserver.HandlerWithResult
}

HandlerDefinition contains method definition to use by HTTP server

type Service

type Service interface {
	GetHandlers() []HandlerDefinition
	Run(ctx context.Context) error
}

Service is an interface that application services should implement

type ServiceFactory

type ServiceFactory func(
	cfg any,
	logger log.MetaLogger,
	metricsRegistry *metrics.Registry,
	statusReporter appstatus.ServiceStatusReporter,
	appInformer AppInformer,
) (Service, error)

ServiceFactory is a function that creates a service instance