Documentation ¶
Overview ¶
Package skv provides a simple persistent key-value store for Go values. It can store a mapping of string to any gob-encodable Go value. It is lightweight and performant, and ideal for use in low-traffic websites, utilities and the like.
The API is very simple - you can Put(), Get() or Delete() entries. These methods are goroutine-safe.
skv uses BoltDB for storage and the encoding/gob package for encoding and decoding values. There are no other dependencies.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ( // ErrNotFound is returned when the key supplied to a Get or Delete // method does not exist in the database. ErrNotFound = errors.New("skv: key not found") // ErrBadValue is returned when the value supplied to the Put method // is nil. ErrBadValue = errors.New("skv: bad value") )
Functions ¶
This section is empty.
Types ¶
type KVStore ¶
type KVStore struct {
// contains filtered or unexported fields
}
KVStore represents the key value store. Use the Open() method to create one, and Close() it when done.
func Open ¶
Open a key-value store. "path" is the full path to the database file, any leading directories must have been created already. File is created with mode 0640 if needed.
Because of BoltDB restrictions, only one process may open the file at a time. Attempts to open the file from another process will fail with a timeout error.
func (*KVStore) Delete ¶
Delete the entry with the given key. If no such key is present in the store, it returns ErrNotFound.
store.Delete("key42")
func (*KVStore) Get ¶
Get an entry from the store. "value" must be a pointer-typed. If the key is not present in the store, Get returns ErrNotFound.
type MyStruct struct { Numbers []int } var val MyStruct if err := store.Get("key42", &val); err == skv.ErrNotFound { // "key42" not found } else if err != nil { // an error occurred } else { // ok }
The value passed to Get() can be nil, in which case any value read from the store is silently discarded.
if err := store.Get("key42", nil); err == nil { fmt.Println("entry is present") }
func (*KVStore) Put ¶
Put an entry into the store. The passed value is gob-encoded and stored. The key can be an empty string, but the value cannot be nil - if it is, Put() returns ErrBadValue.
err := store.Put("key42", 156) err := store.Put("key42", "this is a string") m := map[string]int{ "harry": 100, "emma": 101, } err := store.Put("key43", m)