bitcask-mirror/README.md
2019-03-13 07:43:32 +10:00

1.7 KiB

bitcask

Build Status CodeCov Go Report Card GoDoc Sourcegraph

A Bitcask (LSM+WAL) Key/Value Store written in Go.

Features

  • Embeddable
  • Builtin CLI

Install

$ go get github.com/prologic/bitcask

Usage (library)

Install the package into your project:

$ go get github.com/prologic/bitcask
package main

import (
    "log"

    "github.com/prologic/bitcask"
)

func main() {
    db, _ := bitcask.Open("/tmp/db")
    db.Set("Hello", []byte("World"))
    db.Close()
}

See the godoc for further documentation and other examples.

Usage (tool)

$ bitcask -p /tmp/db set Hello World
$ bitcask -p /tmp/db get Hello
World

Performance

Benchmarks run on a 11" Macbook with a 1.4Ghz Intel Core i7:

$ make bench
...
BenchmarkGet-4   	  300000	      5065 ns/op	     144 B/op	       4 allocs/op
BenchmarkPut-4   	  100000	     14640 ns/op	     699 B/op	       7 allocs/op
  • ~30,000 reads/sec for non-active data
  • ~180,000 reads/sec for active data
  • ~60,000 writes/sec

License

bitcask is licensed under the MIT License