Another high-level API for creating secondary leveldb indexes
JavaScript
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
test
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
example.js
index.js
package.json
yarn.lock

README.md

level-idx

High Level leveldb indexing API using level-auto-index.

npm install level-idx

level badge npm Build Status dependencies Status devDependencies Status

Usage

Index posts by title and body length, then query for them:

var Index = require('level-idx')
var level = require('memdb')
var sub = require('subleveldown')

var db = level()
var posts = sub(db, 'posts', {valueEncoding: 'json'})
var idx = sub(db, 'idx')

Index(posts, idx)
  .by('Title', 'title')
  .by('Length', ['body.length', 'title'])
  .by('Author', ['author', 'title'])

var post = {
  title: 'a title',
  body: 'lorem ipsum',
  author: 'julian'
}

posts.put('1337', post, function (err) {
  if (err) throw err

  posts.byTitle.get('a title', console.log)
  posts.byLength.get('11!a title', console.log)
  posts.byAuthor.get('julian!a title', console.log)
})

API

Index(db, idb)

Index db into idb.

Index#by(name, props)

Create an index called name and index by props.

props should be a string or an array of strings that each name a property. Deep object access is enabled via deep-access. Use multiple properties if you can't guarantee the uniqueness of the first property's value.

If a property doesn't exist, e.g. if you want to index by body.length but there is no key body, it will be ignored.

Index.db

The underlying db.

Index.db.by{Name}.get(key[, opts], fn)

Index.db.by{Name}.create{Key,Value,Read}Stream([opts])

See level-auto-index.

Multilevel

Populate db.methods with the manifests of each indexed db.object:

var index = require('level-idx');
var createManifest = require('level-manifest');

db.methods = {};
db.posts = index(db.sublevel('posts'))
  .by('Slug', ['slug'])
  .db;
db.methods.posts = {
  type: 'object',
  methods: createManifest(db.posts).methods
};

See Also

This module is a port of juliangruber/level-sec that works/uses subleveldown and level-auto-index.