levelnet v0.3.0

LEVELNET

Remote API bindings for LevelUP

A replication of the LevelDB API on the client. Full API coverage using battle hardened mux-demux and dnode to provide the streaming RPC mechanism. Create a LevelUP instance, pass it to a Levelnet server function and get a duplex stream to pipe into. The client() function returns a stream which also has the full levelUP API integrated.

DUPLICATE MODULE WARNING

Another module, multilevel, exists and provides the same functionalityas levelnet - though levelnet uses dnode whereas multilevel uses rpc-stream. If in doubt use multilevel - it has been around longer and does some extra stuff that might be useful. I also changed levnet's API to match multilevel so you can just drop in either and they'll work.

EXAMPLES

SIMPLE SERVER

var levelup = require('levelup')
  , db = levelup('./testdb')
  , net = require('net')
  , levnet = require('../.')

var PORT = 9988
  , server = net.createServer(handler).listen(PORT)

function handler(stream) {
  var lev = levnet.server(db)
  stream.pipe(lev).pipe(stream)
}

SIMPLE CLIENT Callback API

var levnet = require('../../.')
  , net = require('net')

var PORT = 9988
  , stream = net.connect(PORT)

var lev = levnet.client()

lev.on('levelup', function () {
  lev.put('lando', 'calrissian', function(err) {
    if (err) console.log(err)

    lev.get('lando', function (err, value) {
      if (err) return console.log('No Lando!', err)
      console.log('lando', '=', value)

      lev.get('Cloud City', function (err, value) {
        if (err) return console.log('no Cloud City!', err)
        console.log('faruq', '=', value)
      })
    })
  })
})

SIMPLE CLIENT Streaming API

var levnet = require('../../.')
  , net = require('net')

var PORT = 9988
var stream = net.connect(PORT)
var lev = levnet.client()

lev.on('levelup', function () {
  lev.put('Yavin', 'Corsusca', function(err) {
    if (err) console.log(err)

    lev.put('Boba', 'Fett', function(err) {
      if (err) console.log(err)

      lev.createReadStream().on('data', function (data) {
        console.log(data.key, '=', data.value)
        lev.end()
      })
    })
  })
})

stream.pipe(lev).pipe(stream)

INSTALL

npm install levelnet

LICENSE

MIT