utils

A small, opinionated bundle of Go helpers used across kb/* services — retry/backoff, slug, env loading, structured errors. Zero non-stdlib runtime dependencies; everything else is dev-only.

Install

# Go module
go get code.kbenestad.net/kb/utils@v2.4.0

# Or via kbpkg, our internal package manager
kbpkg install kb/utils

Usage

package main

import (
    "context"
    "code.kbenestad.net/kb/utils/retry"
)

func main() {
    ctx := context.Background()
    _ = retry.Do(ctx, retry.Default, func() error {
        // network call here
        return nil
    })
}

What's inside

• retry — context-aware exponential backoff with full jitter (cap 30s).
• slug — Unicode-correct slugification; handles combining marks.
• envx — typed env loading with defaults and required-key checks.
• errs — structured error wrapping that survives JSON round-trips.
• iox — small io helpers (limited readers, atomic file writes).

Stability

Public API follows semver. Anything under internal/ is fair game and will change without notice.