lifecycle

type App ¶

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

App owns the lifecycle of its components and is run once.

func New(options Options, components ...Component) *App

func (a *App) Run(ctx context.Context) (err error)

func (a *App) RunSignals() error

type Component ¶

type Component interface {
	Start(context.Context) error
	Wait() error
	Stop(context.Context) error
}

Component represents a server or background worker. Start returns when ready; Wait blocks until execution ends and returns nil for normal shutdown. Stop must respect its context and release partially started resources even if Start failed. Stop must also allow Wait to finish.

type Options ¶

type Options struct {
	// ShutdownTimeout bounds the shared shutdown phase; zero defaults to 10s.
	ShutdownTimeout time.Duration
	// Cleanup is typically the callback returned by a generated initializer.
	// It runs after shutdown, including on startup failure or cancellation.
	Cleanup func() error
}