lukechampine.com/lite3

lite3

go get lukechampine.com/lite3

This repo contains a pure-Go implementation of Lite³, a zero-copy binary serialization format. Lite³ represents data as a B-tree inside a single contiguous buffer, allowing access and mutation on any arbitrary field in O(log n) time.

Usage

The API is fairly low-level. There are two container types: Object and Array, which each have Get and Set methods for reading and writing Value objects. Object keys are hashed; hence the Key constructor, whose result can be stored to boost performance when accessing the same key many times.

import "lukechampine.com/lite3"
import "fmt"

func main() {
    b := lite3.New(nil)
    o := b.SetRootObject()
	o.Set("foo", lite3.Bool(true))
    fmt.Println(o.Value(lite3.Key("foo")).Bool()) // true
    
    // nested containers:
    a := o.SetArray(lite3.Key("bar"))
    a.Set(0, lite3.String("hello"))
    a.Set(1, lite3.String("world"))

    // iteration:
    for key, val := range o.All() {
        if val.Type == lite3.TypeArray {
            for i, val := range val.All() {
                fmt.Println(i, val) // 0 hello
                break
            }
        } else {
            fmt.Println(key, val) // foo true
        }
    }

    // json compatibility:
    js, _ := b.MarshalJSON()
    fmt.Println(string(js)) // {"bar":["hello","world"],"foo":true}
    
    var b2 lite3.Buffer
    b2.UnmarshalJSON(js)
    fmt.Println(b2.Root().(lite3.Object).Value(lite3.Key("foo"))) // true
}

Performance

~10% slower than json.Marshal when encoding, but ~7x faster when decoding. Individual Get/Set operations are ~15ns.