molecule-core/platform/internal/envx/envx.go

// Package envx holds tiny helpers for reading tunable values from
// environment variables with a safe default. Named `envx` rather than
// `env` to avoid collision with Go's net/http and common third-party
// packages that use `env` as a var/import name.
//
// Rules of thumb for the helpers:
//   - Unset variable  → default
//   - Unparseable     → default (never crash startup)
//   - Parsed but ≤ 0  → default (a "disabled" override is almost always
//     a misconfiguration; use a feature flag instead)
package envx

import (
	"os"
	"strconv"
	"time"
)

// Duration reads `name` as a time.Duration string (e.g. "30s", "5m").
// Returns `def` when unset, unparseable, or non-positive.
func Duration(name string, def time.Duration) time.Duration {
	if v := os.Getenv(name); v != "" {
		if d, err := time.ParseDuration(v); err == nil && d > 0 {
			return d
		}
	}
	return def
}

// Int64 reads `name` as a base-10 int64. Returns `def` when unset,
// unparseable, or non-positive.
func Int64(name string, def int64) int64 {
	if v := os.Getenv(name); v != "" {
		if n, err := strconv.ParseInt(v, 10, 64); err == nil && n > 0 {
			return n
		}
	}
	return def
}