config

Documentation

Overview

Package config parses the WAVEFRONT_* environment once at startup into an immutable Config. Required vars missing ⇒ MissingError; malformed values ⇒ InvalidError (both name the offending var). Load uses the functional-options pattern: production calls config.Load(); tests inject a fixed environment with config.Load(config.WithLookup(fake)).

Index

• type Config
  • func Load(opts ...Option) (*Config, error)
• type InvalidError
  • func (e *InvalidError) Error() string
  • func (e *InvalidError) Unwrap() error
• type Lookuper
• type MissingError
  • func (e *MissingError) Error() string
• type Option
  • func WithLookup(fn Lookuper) Option

Types

type Config

type Config struct {
	BundlePath            string
	UpstreamBaseURL       string
	ListenAddr            string
	MetricsAddr           string
	ContractVersionHeader string
	RequestTimeout        time.Duration
	MaxBodyBytes          int64
	LogLevel              slog.Level
}

func Load

func Load(opts ...Option) (*Config, error)

Load parses the WAVEFRONT_* environment once into an immutable Config. Production: config.Load(). Tests: config.Load(config.WithLookup(fake)).

type InvalidError

type InvalidError struct {
	Var   string
	Value string
	Err   error
}

func (*InvalidError) Error

func (e *InvalidError) Error() string

func (*InvalidError) Unwrap

func (e *InvalidError) Unwrap() error

type Lookuper

type Lookuper func(key string) (string, bool)

Lookuper resolves an environment variable: its value and whether it is set. It matches the signature of os.LookupEnv.

type MissingError

type MissingError struct{ Var string }

func (*MissingError) Error

func (e *MissingError) Error() string

type Option

type Option func(*loader)

Option configures Load.

func WithLookup

func WithLookup(fn Lookuper) Option

WithLookup overrides the environment source (default os.LookupEnv). Tests use it to supply a fixed, in-memory environment.