configurator

README

Configurator

Helpers for deployment and app setup.

go get -u github.com/a-novel-kit/configurator

Documentation

Index

• type ConfigFile
  • func NewConfig(env string, file []byte) ConfigFile
• type Loader
  • func NewLoader[T any](config LoaderConfig) *Loader[T]
  • func (loader *Loader[T]) Load(files ...ConfigFile) (T, error)
  • func (loader *Loader[T]) MustLoad(files ...ConfigFile) T
• type LoaderConfig

Types

type ConfigFile

type ConfigFile struct {
	// contains filtered or unexported fields
}

ConfigFile represents an embedded .yaml file, that holds the configuration object.

func NewConfig

func NewConfig(env string, file []byte) ConfigFile

NewConfig creates a new ConfigFile object, targeted to a specific environment. To create a global configuration file, leave the environment empty.

type Loader

type Loader[T any] struct {
	// contains filtered or unexported fields
}

Loader is an interface used to load configuration files using environment information.

func NewLoader

func NewLoader[T any](config LoaderConfig) *Loader[T]

NewLoader creates a new Loader object.

func (*Loader[T]) Load

func (loader *Loader[T]) Load(files ...ConfigFile) (T, error)

func (*Loader[T]) MustLoad

func (loader *Loader[T]) MustLoad(files ...ConfigFile) T

type LoaderConfig

type LoaderConfig struct {
	// Deserializer used to unmarshal the file content. Defaults to json.Unmarshal.
	Deserializer func(data []byte, dst any) error

	// If true, env variable declarations are automatically interpolated with their
	// actual value from the environment.
	ExpandEnv bool

	// The current environment. Uses the value in "ENV" variable by default.
	Env string
}

LoaderConfig sets a file loader.