lric

Riak & Riak CS client wrappers for LFE

Contents

• Introduction
• Installation
• Usage
• Documentation
• License

Introduction ↟

Mostly because the module names of the Erlang Riak client are a bit cumbersome. And not Lispy.

Installation ↟

You need to use rebar3. Just add it to your rebar.config deps:

  {deps, [
    {lric, {git, "[email protected]:lfex/lric.git", {branch, "master"}}}
  ]}.

And then do:

$ rebar3 compile

Usage ↟

Below is a quick sample from the Riak docs converted to LFE and lric. First, let's start up the LFE REPL:

$ make repl
Erlang/OTP 19 [erts-8.2.1] [source] [64-bit] [smp:4:4] [ds:4:4:10] ...

   ..-~.~_~---..
  (      \\     )    |   A Lisp-2+ on the Erlang VM
  |`-.._/_\\_.-':    |   Type (help) for usage info.
  |         g |_ \   |
  |        n    | |  |   Docs: http://docs.lfe.io/
  |       a    / /   |   Source: http://github.com/rvirding/lfe
   \     l    |_/    |
    \   r     /      |   LFE v1.3-dev (abort with ^G)
     `-E___.-'

lfe>

Then let's connect to the Riak server and define some variables:

lfe> (set `#(ok ,pid) (lric:start-link "127.0.0.1" 8087))
#(ok <0.32.0>)
lfe> (set my-bucket #"test")
#"test"
lfe> (set key #"key")
#"key"
lfe> (set value #"a value")
#"a value"

With these in place, we can create an object:

lfe> (set obj (lrico:new my-bucket key value))
#(riakc_obj #"test" #"key" undefined () undefined #"a value")
lfe>

And then store it in Riak:

lfe> (lric:put pid obj)
ok

Now let's get it back out of Riak:

lfe> (set `#(ok ,result) (lric:get pid my-bucket key))
#(ok
  #(riakc_obj
    #"test"
    #"key"
    #B(107 206 97 96 96 96 204 96 202 5 82 60 202 156 255 126 62 191 180 112 62 3 243 247 133 25 ...)
    (#(#(dict 2 16 16 8 80 48
         #(() () () () () () () () () () () () () () () ...)
         #(#(() () () () () () () () () () ((#"X-Riak-VTag" ...)) () () ...)))
       #"a value"))
    undefined undefined))

That's the complete Riak object; how do we get just the value? Simply call the appropriate object function:

lfe> (lrico:get-value result)
#"a value"

Documentation ↟

For more usage examples, see the following docs (all of which are being ported by Billo from the Basho originals):

• Taste of Riak
• The Little Riak Book (TBD)
• Basic Usage (TBD)
• Riak Search (TBD)
• Riak Data Types (TBD)

License ↟

Apache License, Version 2.0

Copyright © 2014-2017, BilloSystems, Ltd. Co.

Copyright © 2017, Ricardo Lanziano

Copyright © 2017, Duncan McGreggor