README
¶
lakta
An opinionated golang microservice framework.
Installation
Lakta is split into per-integration modules — install only what you use:
go get github.com/Vilsol/lakta@latest # core runtime + config
go get github.com/Vilsol/lakta/pkg/http/fiber@latest # HTTP (Fiber)
go get github.com/Vilsol/lakta/pkg/workflows/temporal@latest
Contributing
This is a multi-module workspace. After pulling changes that touch
dependencies, run go work sync. CI runs every module via mise run ci-all.
Libraries
| Purpose | Name | Library |
|---|---|---|
| Log API | slog | log/slog |
| Log Formatter | tint | github.com/lmittmann/tint |
| Dependency Injection | Do | github.com/samber/do/v2 |
| Configuration | Koanf | github.com/knadh/koanf/v2 |
| Logging | OpenTelemetry | go.opentelemetry.io/otel/log |
| Metrics | OpenTelemetry | go.opentelemetry.io/otel/metric |
| Tracing | OpenTelemetry | go.opentelemetry.io/otel/trace |
| HTTP Server | Fiber | github.com/gofiber/fiber/v3 |
| GRPC Server | Google GRPC | google.golang.org/grpc |
| SQL Database | squirrel | github.com/Masterminds/squirrel |
| Postgres Database | pgx | github.com/jackc/pgx/v5 |
| Health Check | health-go | github.com/hellofresh/health-go/v5 |
| Testing | testza | github.com/MarvinJWendt/testza |
| Error Handling | oops | github.com/samber/oops |
| Goroutine Management | conc | github.com/sourcegraph/conc |
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
module
|
|
|
pkg
|
|
|
cache
Package cache is the backend-agnostic caching seam for lakta.
|
Package cache is the backend-agnostic caching seam for lakta. |
|
config
Package config provides a configuration system for Lakta using koanf.
|
Package config provides a configuration system for Lakta using koanf. |
|
errors
Package errors is the transport-agnostic error substrate.
|
Package errors is the transport-agnostic error substrate. |
|
lakta
Package lakta provides the core module system and runtime for building microservices.
|
Package lakta provides the core module system and runtime for building microservices. |
|
auth/verifier
module
|
|
|
cache/memory
module
|
|
|
db/drivers/pgx
module
|
|
|
db/sql
module
|
|
|
debug/actuator
module
|
|
|
errors/fiber
module
|
|
|
errors/grpc
module
|
|
|
events
module
|
|
|
features/flags
module
|
|
|
grpc
module
|
|
|
health
module
|
|
|
http/connect
module
|
|
|
http/fiber
module
|
|
|
logging/slog
module
|
|
|
logging/tint
module
|
|
|
otel
module
|
|
|
reflectcfg
module
|
|
|
resilience/policy
module
|
|
|
testkit
module
|
|
|
validation/fiber
module
|
|
|
workers/pool
module
|
|
|
workers/scheduler
module
|
|
|
workflows/temporal
module
|
Click to show internal directories.
Click to hide internal directories.