amp

Abstract Message Protocol codec and streaming parser for golang.

Godoc

Installation

$ go get github.com/nickpoorman/go-amp

Example

args := [][]byte{[]byte("Hello"), []byte("World")}
bin := Encode(args)
msg := Decode(bin)
fmt.Printf("%s\n", msg)

Protocol

AMP is a simple versioned protocol for framed messages containing zero or more "arguments". Each argument is opaque binary, thus you may use JSON, BSON, msgpack and others on top of AMP. Multiple argument support is used to allow a hybrid of binary/non-binary message args without requiring higher level serialization libraries like msgpack or BSON.

All multi-byte integers are big endian. The version and argc integers are stored in the first byte, followed by a sequence of zero or more <length> / <data> pairs, where length is a 32-bit unsigned integer.

      0        1 2 3 4     <length>    ...
+------------+----------+------------+
| <ver/argc> | <length> | <data>     | additional arguments
+------------+----------+------------+

Implementations

• c (~10m ops/s)
• node (~1.5m ops/s)
• golang this library (~6.2m ops/s)

License

MIT