tempire/app-karyn

Command line utility to add/list/remove Riak objects

NAME

App::karyn

DESCRIPTION

Command line utility for perusing buckets and keys in Riak

Why is it named Karyn?

Every Stargate SG1 fan who mispronounces "Riak" initially, should be able to answer this question.

Rya'c is Teal'c's son.

Karyn is Rya'c's wife.

Karyn is a helper for Riak.

INSTALL

Requires Riak::Tiny

Tests require a Riak instance listening on http://localhost:8098

curl -L http://github.com/tempire/app-karyn/raw/master/install | sh

USAGE

Defaults to http://127.0.0.1:8098/. See below for specifying other hosts.

Add a bucket, key, and value

karyn add --bucket b --key k --value v
karyn add b/k v

Show a key's value

karyn list --bucket b --key k
karyn list -b k -k k
karyn list b/k

Show JSON value as perl structure

karyn list --bucket b --key k --perl
karyn list -b b -k k -p
karyn list b/k -p

List all keys in bucket

karyn list --bucket b
karyn list b

Search all buckets for a key

karyn list --bucket _ --key name
karyn list --key name
karyn list _/name

Delete key

karyn delete --bucket b --key k
karyn delete -b b -k k
karyn delete b/k

Delete all keys in bucket

karyn delete --bucket b
karyn delete -b b -d

DEBUGGING

Display full http request & response

MOJO_CLIENT_DEBUG=1 karyn list

CONNECT TO ANOTHER HOST

RIAK_HOST=http://anotherhost:port karyn list

or (with bash)

export RIAK_HOST=http://anotherhost:port
karyn list

Keep in mind that you can reset the env variable after you set it:

unset RIAK_HOST