cfg

Documentation

Index

• Variables
• func Parse(dst Cloneable) error
• func Unmarshal(dst Cloneable, sources ...Source) error
• type Cloneable
• type Source
  • func Defaults() Source
  • func Flags() Source
  • func JSON(f *string) Source
  • func YAML(f string, expandEnvVars bool) Source
  • func YAMLFlag(args []string, name string) Source

Variables

var (
	ErrNotPointer = errors.New("dst is not a pointer")
)

Functions

func Parse

func Parse(dst Cloneable) error

Parse is a higher level wrapper for Unmarshal that automatically parses flags and a .yaml file

func Unmarshal

func Unmarshal(dst Cloneable, sources ...Source) error

Unmarshal merges the values of the various configuration sources and sets them on `dst`. The object must be compatible with `json.Unmarshal`.

Types

type Cloneable

type Cloneable interface {
	Clone() flagext.Registerer
}

Cloneable is a config which can be cloned into a flagext.Registerer Contract: the cloned value must not mutate the original.

type Source

type Source func(Cloneable) error

Source is a generic configuration source. This function may do whatever is required to obtain the configuration. It is passed a pointer to the destination, which will be something compatible to `json.Unmarshal`. The obtained configuration may be written to this object, it may also contain data from previous sources.

func Defaults

func Defaults() Source

Defaults registers flags to the command line using dst as the flagext.Registerer

func Flags

func Flags() Source

Flags parses the flag from the command line, setting only user-supplied values on the flagext.Registerer passed to Defaults()

func JSON

func JSON(f *string) Source

JSON returns a Source that opens the supplied `.json` file and loads it.

func YAML

func YAML(f string, expandEnvVars bool) Source

YAML returns a Source that opens the supplied `.yaml` file and loads it. When expandEnvVars is true, variables in the supplied '.yaml\ file are expanded using https://pkg.go.dev/github.com/drone/envsubst?tab=overview

func YAMLFlag

func YAMLFlag(args []string, name string) Source