level-onion

0.0.2 • Public • Published

level-onion

NPM

Extend a levelup instance in layers, like an onion.

Each layer you add can expose new functionality or modify functionality of inner layers, or you can bypass the layers by using the inner unmodified layers.

WARNING This is currently experimental, and primarily a proof-of-concept. There are no guarantees that this will be a best practice for working with levelup, or be adopted by any significant portion of the levelup ecosystem.

Pros: Simple & low impact.

Cons: I'm not exactly thrilled with the convention it requires wrapping modules to comply with.


Example: case-insensitive keys:

Create a wrapping layer:

  function Upper() {
    // Required
    this.type = "upper"
    // Default false, if true it will prevent you from double-wrapping with this wrapper.
    this.unique = false
  }
 
  // Requires an install method that takes the wrapped db and the parent it is wrapping
  Upper.prototype.install = function (db, parent) {
    db.put = function (key, value, cb) {
      parent.put(key.toUpperCase(), value, cb)
    }
 
    db.get = function (key, cb) {
      parent.get(key.toUpperCase(), cb)
    }
 
    // ... etc.
  }

Wrap a levelup instance with your wrapping layer:

var level = require("level")
var wrap = require("level-onion")
 
var ldb = level("/tmp/db")
var db = wrap(db, new Upper())
// ldb remains intact and unmodified
// db now has the wrapper installed

Readme

Keywords

none

Package Sidebar

Install

npm i level-onion

Weekly Downloads

3

Version

0.0.2

License

MIT

Last publish

Collaborators

  • bryce