README
¶
Stow
Usage
This package provides a persistence manager for objects backed by boltdb.
package stow
import (
"os"
"testing"
"github.com/boltdb/bolt"
)
func TestJson(t *testing.T) {
// Create a boltdb database
db, err := bolt.Open("my.db", 0600, nil)
if err != nil {
t.Error(err.Error())
}
defer os.Remove("my.db")
defer db.Close()
// Defined our test Type
type MyType struct {
FirstName string `json:"first"`
LastName string `json:"last"`
}
// Create a Json-encoded Store, Xml and Gob are also built-in
// We'll we store the name in a boltdb bucket named "names"
store := NewJSONStore(db, []byte("names"))
// Store the object
store.Put("hello", &MyType{"Derek", "Kered"})
// For each element in the store
store.ForEach(func(key string, name MyType){
fmt.Println(key, name)
})
// Get the object
var name MyType
store.Pull("hello", &name)
// Verify
if name.FirstName != "Derek" || name.LastName != "Kered" {
t.Errorf("Unexpected name: %v", name)
}
}
Installation
go get github.com/djherbis/stow
Documentation
¶
Overview ¶
Package stow is used to persist objects to a bolt.DB database.
Index ¶
Constants ¶
This section is empty.
Variables ¶
ErrNotFound indicates object is not in database.
Functions ¶
func Register ¶
func Register(value interface{})
Register registers the type using gob.Register for use with NewStore() and the GobCodec.
Types ¶
type Codec ¶
Codec provides a mechanism for storing/retriving objects as streams of data.
type Decoder ¶
type Decoder interface {
Decode(interface{}) error
}
Decoder is used to decode objects
type Encoder ¶
type Encoder interface {
Encode(interface{}) error
}
Encoder is used to encode objects
type GobCodec ¶
type GobCodec struct{}
GobCodec is used to encode/decode using the Gob format.
func (GobCodec) NewDecoder ¶
NewDecoder returns a new gob decoder which reads from r
type JSONCodec ¶
type JSONCodec struct{}
JSONCodec is used to encode/decode JSON
func (JSONCodec) NewDecoder ¶
NewDecoder returns a new json decoder which reads from r
type Store ¶
type Store struct {
// contains filtered or unexported fields
}
Store manages objects persistence.
func NewCustomStore ¶
NewCustomStore allows you to create a store with a custom underlying Encoding
func NewJSONStore ¶
NewJSONStore creates a new Store, using the underlying bolt.DB "bucket" to persist objects as json.
func NewStore ¶
NewStore creates a new Store, using the underlying bolt.DB "bucket" to persist objects. NewStore uses GobEncoding, your objects must be registered via gob.Register() for this encoding to work.
func NewXMLStore ¶
NewXMLStore creates a new Store, using the underlying bolt.DB "bucket" to persist objects as xml.
func (*Store) ForEach ¶
ForEach will run do on each object in the store. do can be a function which takes either: 1 param which will take on each "value" or 2 params where the first param is the "key" and the second is the "value".
func (*Store) Get ¶
Get will retrieve b with key "key". If key is []byte or string it uses the key directly. Otherwise, it marshals the given type into bytes using the stores Encoder.
func (*Store) Pull ¶
Pull will retrieve b with key "key", and removes it from the store.
Source Files