https://github.com/tucnak/store
A dead simple configuration manager for Go applications
https://github.com/tucnak/store
Last synced: 2 months ago
JSON representation
A dead simple configuration manager for Go applications
- Host: GitHub
- URL: https://github.com/tucnak/store
- Owner: tucnak
- License: mit
- Created: 2015-10-03T19:17:28.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2023-07-14T15:44:13.000Z (over 2 years ago)
- Last Synced: 2025-03-30T05:08:46.794Z (7 months ago)
- Language: Go
- Size: 12.7 KB
- Stars: 276
- Watchers: 6
- Forks: 21
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - store - Lightweight configuration manager for Go. (Configuration / Standard CLI)
- fucking-awesome-go - store - Lightweight configuration manager for Go. (Configuration / Standard CLI)
- awesome-go - store - Lightweight configuration manager for Go. (Configuration / Standard CLI)
- awesome-go - store - Lightweight configuration manager for Go. (Configuration / Standard CLI)
- awesome-go-extra - store - 10-03T19:17:28Z|2017-09-05T11:38:35Z| (Configuration / Advanced Console UIs)
- awesome-go-with-stars - store - Lightweight configuration manager for Go. (Configuration / Standard CLI)
- awesome-go-cn - store
- awesome-go-plus - store - Lightweight configuration manager for Go.  (Configuration / Standard CLI)
- awesome-go-plus - store - Lightweight configuration manager for Go.   (Configuration / Standard CLI)
- awesome-go - store - A dead simple configuration manager for Go applications - ★ 235 (Configuration)
README
# Store
>Store is a dead simple configuration manager for Go applications.
[](https://godoc.org/github.com/tucnak/store)
I didn't like existing configuration management solutions like [globalconf](https://github.com/rakyll/globalconf), [tachyon](https://github.com/vektra/tachyon) or [viper](https://github.com/spf13/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:
```go
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:
```go
store.Register("ini", ini.Marshal, ini.Unmarshal)
err := store.Load("configuration.ini", &object)
// ...
```