Pogreb

Pogreb is an embedded key-only store for read-heavy workloads written in Go.

Key characteristics

• 100% Go.
• Optimized for fast random lookups and infrequent bulk inserts.
• Can store larger-than-memory data sets.
• Low memory usage.
• All DB methods are safe for concurrent use by multiple goroutines.

Installation

$ go get -u github.com/domaincrawler/pogreb

Usage

Opening a database

To open or create a new database, use the pogreb.Open() function:

package main

import (
	"log"

	"github.com/domaincrawler/pogreb"
)

func main() {
    db, err := pogreb.Open("pogreb.test", nil)
    if err != nil {
        log.Fatal(err)
        return
    }	
    defer db.Close()
}

Writing to a database

Use the DB.Put() function to insert a new key:

err := db.Put([]byte("testKey"))
if err != nil {
	log.Fatal(err)
}

Reading from a database

To retrieve the inserted value, use the DB.Has() function:

val, err := db.Has([]byte("testKey"))
if err != nil {
	log.Fatal(err)
}
log.Println(val)

Iterating over items

To iterate over items, use ItemIterator returned by DB.Items():

it := db.Items()
for {
    key, err := it.Next()
    if err == pogreb.ErrIterationDone {
    	break
    }
    if err != nil { 
        log.Fatal(err)
    }
    log.Printf("%s", key)
}