Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
simple kv store for streams
JavaScript
Tree: cb6f891eae

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
test
.gitignore
cli.js
client.js
endpoints-client.js
endpoints.js
index.js
kv.js
package.json
readme.markdown

readme.markdown

kv-stream

super simple key-value store, intended for keeping appendable files.

works on the server, with files, and in the browser with localStorage.

on the server, it keeps the files in prefixed subdirectories, so that the directories do not get too large.

(see ls .git/objects/* for a similar example)

examples

create an instance

setup is optional. setup is passed the stream created by put and get, may replace the stream passed to put/get by default, the stream is handled as newline seperated json.

//server
var kv = require('kv')('/tmp/kv')
//client
var kv = require('kv')('kv:') //this will be prefixed to keys when saving in localStorage.

put a stream

opts is optional. see fs.createWriteStream

stream.pipe(kv.put(key, opts))

get a stream

opts is optional. see fs.createReadStream

kv.get(key, opts).pipe(stream) 

del a stream

kv.del(key, callback)

list of keys

kv.list().pipe(stream)

has

check if db has a key

  kv.has(key, function (err, stat) {
    //return the stat of the stream, if it exists.
  })

customization

to handle other types of streams than newline separated json, pass in a stream setup function to kv.

var rawKV = require('kv')(dir, function (stream, key) {
  return stream //just use raw streams, do not parse!
})

cli

there is also a cli tool!

npm install kv -g

echo hello | kv put hello --base /tmp/kv
kv get hello --base /tmp/k

Something went wrong with that request. Please try again.