go-tools

go-tools

Shared building blocks for Nimble Tech Go services: error handling, Gin helpers, tracing, and ready-made initializers wired from environment variables.

Install

go get github.com/tech-nimble/go-tools

Packages

Initializers

Each initializers/* package reads configuration from environment variables and returns a ready-to-use component, e.g.:

pool, err := pg.Initialize()           // initializers/pg  — *pgxpool.Pool
logger := logs.InitializeLogs(writer)  // initializers/logs — zerolog.Logger

Scheduler

initializers/scheduler holds the cron runtime a service would otherwise copy into internal/ports/cronjob. A service only describes its jobs:

cronScheduler := scheduler.Initialize()

scheduler.Register(jobsCtx, cronScheduler, scheduler.Job{
    Name:    "dispatch.expire_offers",
    Spec:    scheduler.EverySpec(cfg.TickInterval),
    Timeout: 10 * time.Second,
    Quiet:   true,
    Run:     func(ctx context.Context) error { return useCase.Execute(ctx) },
})

cronScheduler.Start()

The context passed to Register is the application's, not a request's: canceling it stops the jobs in flight. A job that fails with a timeout is logged at warning level and escalates to error after TransientFailures failures in a row (three by default), so a short database or network outage does not raise an alert that the next tick already cured.

License

MIT © Nimble Tech