Documentation
¶
Overview ¶
Package toml is driver use TOML format content as config source. How to usage please see README and unit tests.
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 := config.String("name")
fmt.Printf("get string\n - val: %v\n", name)
arr1 := config.Strings("arr1")
fmt.Printf("get array\n - val: %#v\n", arr1)
val0 := config.String("arr1.0")
fmt.Printf("get sub-value by path 'arr.index'\n - val: %v\n", val0)
map1 := config.StringMap("map1")
fmt.Printf("get map\n - val: %#v\n", map1)
val0 = config.String("map1.name")
fmt.Printf("get sub-value by path 'map.key'\n - val: %v\n", val0)
// can parse env name(ParseEnv: true)
fmt.Printf("get env 'envKey' val: %s\n", config.String("envKey", ""))
fmt.Printf("get env 'envKey1' val: %s\n", config.String("envKey1", ""))
// Out:
// get config example:
// get string
// - val: app2
// get array
// - val: []string{"alpha", "omega"}
// get sub-value by path 'arr.index'
// - val: alpha
// get map
// - val: map[string]string{"name":"inhere", "org":"GitHub"}
// get sub-value by path 'map.key'
// - val: inhere
// get env 'envKey' val: /bin/zsh
// get env 'envKey1' val: defValue
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
View Source
var Decoder config.Decoder = func(blob []byte, ptr any) (err error) { _, err = toml.Decode(string(blob), ptr) return }
Decoder the toml content decoder
Driver for toml format
View Source
var Encoder config.Encoder = func(ptr any) (out []byte, err error) { buf := new(bytes.Buffer) err = toml.NewEncoder(buf).Encode(ptr) return buf.Bytes(), err }
Encoder the toml content encoder
Functions ¶
This section is empty.
Types ¶
This section is empty.
Click to show internal directories.
Click to hide internal directories.