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

• Constants
• Variables
• func Init(application string)
• 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
• func SetApplicationName(handle string)
• type MarshalFunc
• type UnmarshalFunc

Constants

const StoreInLocalDirectory = "%LOCAL%"

Variables

var ErrAppNameNotFound = errors.New("store: application name not defined")

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

Functions

func Init

func Init(application string)

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.

func SetApplicationName

func SetApplicationName(handle string)

SetApplicationName is DEPRECATED (use Init instead).

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.