store
Lightweight configuration manager for Go.
About store
Store
Store is a dead simple configuration manager for Go applications.
I didn't like existing configuration management solutions like globalconf, tachyon or viper. First two just don't feel right and viper, imo, a little overcomplicated—definitely offering too much for small things. Store supports either JSON, TOML or YAML out-of-the-box and lets you register practically any other configuration format. It persists all of your configurations in either $XDG_CONFIG_HOME or $HOME on Linux and in %APPDATA% on Windows.
Look, when I say it's dead simple, I actually mean it:
package main
import (
"log"
"time"
"github.com/tucnak/store"
)
func init() {
// You must init store with some truly unique path first!
store.Init("cats-n-dogs/project-hotel")
}
type Cat struct {
Name string `toml:"naym"`
Clever bool `toml:"ayy"`
}
type Hotel struct {
Name string
Cats []Cat `toml:"guests"`
Opens *time.Time
Closes *time.Time
}
func main() {
var hotel Hotel
if err := store.Load("hotel.toml", &hotel); err != nil {
log.Println("failed to load the cat hotel:", err)
return
}
// ...
if err := store.Save("hotel.toml", &hotel); err != nil {
log.Println("failed to save the cat hotel:", err)
return
}
}
Store supports any other formats via the handy registration system: register the format once and you'd be able to Load and Save files in it afterwards:
store.Register("ini", ini.Marshal, ini.Unmarshal)
err := store.Load("configuration.ini", &object)
// ...
Frequently Asked Questions
What is store?
store is a Configuration library for the Go programming language. Lightweight configuration manager for Go.
How do I install store?
Install store with the Go module system using `go get tucnak/store`. Check the repository for the current installation instructions.
What category does store belong to?
store is listed under Configuration, specifically Libraries for configuration parsing..