store

README

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)
// ...

Documentation

Overview

Package store is a dead simple configuration manager for Go applications.

Index

• Variables
• func Load(path string, v interface{}) error
• func LoadWith(path string, v interface{}, um UnmarshalFunc) error
• func Register(extension string, m MarshalFunc, um UnmarshalFunc)
• func Save(path string, v interface{}) error
• func SaveWith(path string, v interface{}, m MarshalFunc) error
• type MarshalFunc
• type UnmarshalFunc

Variables

var ErrUnknownFormat = errors.New("store: unknown configuration format")

ErrUnknownFormat is used when we can't automatically determine the file format type (or it is a type we don't support)

Functions

func Load

func Load(path string, v interface{}) error

func LoadWith

func LoadWith(path string, v interface{}, um UnmarshalFunc) error

LoadWith loads the configuration using any unmarshaler at all.

func Register

func Register(extension string, m MarshalFunc, um UnmarshalFunc)

Register is the way you register configuration formats, by mapping some file name extension to corresponding marshal and unmarshal functions. Once registered, the format given would be compatible with Load and Save.

func Save

func Save(path string, v interface{}) error

func SaveWith

func SaveWith(path string, v interface{}, m MarshalFunc) error

SaveWith saves the configuration using any marshaler at all.

Types

type MarshalFunc

type MarshalFunc func(v interface{}) ([]byte, error)

MarshalFunc is any marshaler.

type UnmarshalFunc

type UnmarshalFunc func(data []byte, v interface{}) error

UnmarshalFunc is any unmarshaler.