confmaker

Oct 1, 2026

Changes in this version

+ type ConfigReport struct

+ InstanceName string

+ Prefix string

+ Status ConfigStatus

+ Type string

+ Variables []VariableReport

+ type ConfigStatus string

+ const ConfigFailed

+ const ConfigNotProcessed

+ const ConfigSucceeded

+ type DescribeFlag struct

+ func MakeDescribeFlag(flags *flag.FlagSet) *DescribeFlag

+ func (d *DescribeFlag) Requested() bool

+ func (d *DescribeFlag) Write(loader *Loader, writer io.Writer) error

+ type Diagnostics struct

+ func MakeDiagnostics() *Diagnostics

+ func (d *Diagnostics) Report() LoadReport

type EnvOption

+ func WithDiagnosticHandler(handler func(LoadReport)) EnvOption

+ func WithDiagnostics(diagnostics *Diagnostics) EnvOption

type Handle

+ func (h *Handle[T]) BelongsTo(loader *Loader) bool

+ func (h *Handle[T]) Name() string

+ type LoadProblem struct

+ FieldPath string

+ InstanceName string

+ Kind ErrorKind

+ VariableName string

+ type LoadReport struct

+ Configs []ConfigReport

+ Problems []LoadProblem

+ State LoadState

+ type LoadState string

+ const LoadFailed

+ const LoadInProgress

+ const LoadNotStarted

+ const LoadPanicked

+ const LoadSucceeded

+ type ValueSource string

+ const SourceDefault

+ const SourceEnv

+ const SourceMissing

+ const SourceUnknown

+ const SourceZero

+ type VariableReport struct

+ FieldPath string

+ Name string

+ Source ValueSource

+ Status VariableStatus

+ type VariableStatus string

+ const VariableFailed

+ const VariableNotProcessed

+ const VariableSucceeded

Oct 1, 2026

Changes in this version

+ type ConfigError struct

+ FieldPath string

+ InstanceName string

+ Kind ErrorKind

+ VariableName string

+ func ConfigErrors(err error) []*ConfigError

+ func (e *ConfigError) Error() string

+ func (e *ConfigError) Unwrap() error

+ type ConfigManifest struct

+ InstanceName string

+ Prefix string

+ Variables []Variable

+ type ErrorKind string

+ const ErrorConflict

+ const ErrorDeclaration

+ const ErrorDefaultRender

+ const ErrorEmpty

+ const ErrorParse

+ const ErrorRequired

+ const ErrorUnknownVariable

+ const ErrorValidation

type Loader

+ func (l *Loader) Manifest() ([]ConfigManifest, error)

+ func (l *Loader) Register[T any](name string, opts ...ConfigOption) *Handle[T]

+ func (l *Loader) WriteEnvExample(writer io.Writer) error

+ func (l *Loader) WriteManifestJSON(writer io.Writer) error

+ func (l *Loader) WriteManifestMarkdown(writer io.Writer) error

type Variable

+ Description string

Sep 17, 2026

Changes in this version

+ var ErrNotLoaded = errors.New("configuration is not loaded; call Load first")

+ var ErrRegisteredAfterLoad = errors.New("config registered after Load started; register every config before loading")

+ type ConfigNamer interface

+ ConfigName func() string

+ type ConfigOption interface

+ func WithName(name string) ConfigOption

+ func WithPrefix(prefix string) ConfigOption

+ type EnvOption interface

+ func AllowUnknown(prefixes ...string) EnvOption

+ func WithDump(w io.Writer) EnvOption

+ func WithEnv(vars map[string]string) EnvOption

+ type Handle struct

+ func (h *Handle[T]) Value() (T, error)

+ type LoadOption interface

+ type Loader struct

+ func MakeLoader(opts ...EnvOption) *Loader

+ func (l *Loader) Add[T any](opts ...ConfigOption) *Handle[T]

+ func (l *Loader) Load() error

+ type Variable struct

+ Default string

+ HasDefault bool

+ Name string

+ NotEmpty bool

+ Required bool

+ Secret bool

+ Type string

+ func Manifest[T any](opts ...ConfigOption) ([]Variable, error)

Aug 6, 2026

Changes in this version

+ func LoadDir(dst any, dir string) error

Aug 4, 2026

Changes in this version

+ func Load(dst any, paths ...string) error

+ func Required[T any](instances map[string]T, kind, name string) (T, error)

+ func ResolveSecret(envName string) (secret.Secret, error)

+ type Registry struct

+ func MakeRegistry[T any](items map[string]T) *Registry[T]

+ func (r *Registry[T]) Get(kind, name string) (T, error)

+ func (r *Registry[T]) Names() []string