toml

Documentation

Overview

Package toml is driver use TOML format content as config source

Usage please see example:

Example

config.WithOptions(config.ParseEnv)

// add Decoder and Encoder
config.AddDriver(Driver)

err := config.LoadFiles("testdata/toml_base.toml")
if err != nil {
	panic(err)
}

// fmt.Printf("config data: \n %#v\n", Data())

// load more files
err = config.LoadFiles("testdata/toml_other.toml")
// can also
// config.LoadFiles("testdata/toml_base.toml", "testdata/toml_other.toml")
if err != nil {
	panic(err)
}

// load from string
config.LoadSources(config.Toml, []byte(tomlStr))

// fmt.Printf("config data: \n %#v\n", Data())
fmt.Print("get config example:\n")

name, ok := config.String("name")
fmt.Printf("get string\n - ok: %v, val: %v\n", ok, name)

arr1, ok := config.Strings("arr1")
fmt.Printf("get array\n - ok: %v, val: %#v\n", ok, arr1)

val0, ok := config.String("arr1.0")
fmt.Printf("get sub-value by path 'arr.index'\n - ok: %v, val: %v\n", ok, val0)

map1, ok := config.StringMap("map1")
fmt.Printf("get map\n - ok: %v, val: %#v\n", ok, map1)

val0, ok = config.String("map1.name")
fmt.Printf("get sub-value by path 'map.key'\n - ok: %v, val: %v\n", ok, val0)

// can parse env name(ParseEnv: true)
fmt.Printf("get env 'envKey' val: %s\n", config.DefString("envKey", ""))
fmt.Printf("get env 'envKey1' val: %s\n", config.DefString("envKey1", ""))

// Out:
// get config example:
// get string
// - ok: true, val: app2
// get array
// - ok: true, val: []string{"alpha", "omega"}
// get sub-value by path 'arr.index'
// - ok: true, val: alpha
// get map
// - ok: true, val: map[string]string{"name":"inhere", "org":"GitHub"}
// get sub-value by path 'map.key'
// - ok: true, val: inhere
// get env 'envKey' val: /bin/zsh
// get env 'envKey1' val: defValue

Index

• Variables

Examples

• Package

Variables

var Decoder config.Decoder = func(blob []byte, ptr interface{}) (err error) {
	_, err = toml.Decode(string(blob), ptr)

	return
}

Decoder the toml content decoder

var Driver = &tomlDriver{config.Toml}

Driver for toml

var Encoder config.Encoder = func(ptr interface{}) (out []byte, err error) {
	buf := new(bytes.Buffer)

	err = toml.NewEncoder(buf).Encode(ptr)
	if err != nil {
		return
	}

	return buf.Bytes(), nil
}

Encoder the toml content encoder