The highest tagged major version is v2.

app

package

v1.2.0 Latest Latest Go to latest Published: Jul 13, 2026 License: MIT Imports: 10 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/mirkobrombin/go-foundation

Links

Open Source Insights

Documentation ¶

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type App ¶

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

App orchestrates DI, HTTP, dispatching, and scheduling into a single entrypoint.

func New ¶

func New() *App

New creates a new App with default components.

func (*App) Actions ¶ added in v1.2.0

func (a *App) Actions() []string

Actions returns registered struct-tagged action names.

func (*App) Build ¶

func (a *App) Build() (*di.Container, error)

Build constructs the DI container and registers all handlers.

func (*App) Configure ¶

func (a *App) Configure(fn func(*srv.Server)) *App

Configure allows direct customization of the underlying srv.Server.

func (*App) Dispatch ¶

func (a *App) Dispatch(ctx context.Context, name string, payload ...any) (any, error)

Dispatch calls a named action handler.

func (*App) DispatchKey ¶ added in v1.2.0

func (a *App) DispatchKey(ctx context.Context, key string, payload ...any) (any, error)

DispatchKey calls a struct-tagged action handler by key binding.

func (*App) KeyBindings ¶ added in v1.2.0

func (a *App) KeyBindings() map[string]string

KeyBindings returns struct-tagged action key bindings.

func (*App) Listen ¶

func (a *App) Listen(addr string) error

Listen starts the HTTP server and scheduler, then blocks until shutdown.

func (*App) Log ¶

func (a *App) Log(logger *slog.Logger) *App

Log sets the application logger.

func (*App) Provide ¶

func (a *App) Provide(name string, instance any) *App

Provide registers a named dependency for injection into handler structs.

func (*App) RegisterAction ¶

func (a *App) RegisterAction(name string, handler func(ctx context.Context, payload ...any) (any, error)) *App

RegisterAction registers a named action handler for dispatch.

func (*App) RegisterActionHandler ¶ added in v1.2.0

func (a *App) RegisterActionHandler(h actions.Handler) *App

RegisterActionHandler registers a struct-tagged action handler.

func (*App) RegisterHTTP ¶

func (a *App) RegisterHTTP(h Handler) *App

RegisterHTTP registers a struct-tagged HTTP handler.

func (*App) Schedule ¶

func (a *App) Schedule(name, cronExpr string, handler func(ctx context.Context) error) *App

Schedule registers a cron job.

func (*App) Use ¶

func (a *App) Use(mw srv.Middleware) *App

Use adds middleware to the HTTP server.

func (*App) UseActionEvents ¶ added in v1.2.0

func (a *App) UseActionEvents(bus *events.Bus) *App

UseActionEvents emits action instances after dispatch.

func (*App) UseAsyncActionEvents ¶ added in v1.2.0

func (a *App) UseAsyncActionEvents(bus *events.Bus) *App

UseAsyncActionEvents emits action instances asynchronously after dispatch.

type Handler ¶

type Handler interface {
	Handle(ctx context.Context) (any, error)
}

Handler is the interface for declarative struct-tagged endpoints.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL