go-utils

README

go-utils

Reusable Go utilities. Each tool lives in its own package so importers only pull in what they use.

Package	Description
configmanager	Generic, type-safe, hot-reloading JSON config loader.

configmanager

import "github.com/pliu/go-utils/configmanager"

type AppConfig struct {
    ListenAddr string `json:"listen_addr" validate:"required"`
    MaxConns   int    `json:"max_conns"`
}

mgr, err := configmanager.New[AppConfig]("/etc/app/config.json")
if err != nil {
    log.Fatal(err) // invalid initial config: fail fast, never start on a bad config
}
defer mgr.Close()

cfg := mgr.Get()          // shared read-only snapshot (do not mutate)
mine := mgr.GetDeepCopy() // fully isolated copy (safe to mutate)

• The file is polled in the background (default every 3s, see WithPollInterval). A changed file is decoded and validated into a fresh shadow instance and atomically promoted only if valid; an invalid file never disturbs the config being served (inspect via Err() / WithOnError, observe swaps via WithOnSwap).
• Decoding tolerates unknown fields, and rejects type mismatches on defined fields, duplicate JSON keys, and trailing data. Required fields are declared with validate:"required" tags (go-playground/validator); custom rules go in a Validate() error method or WithValidator.
• Snapshots are stable: a reload swaps in a new instance, so values already returned by Get/GetDeepCopy never change under the caller.