index-level
v0.0.2
Published
Simple indexing for leveldb
Downloads
4
Readme
A simple indexer for leveldb.
Not ready for production use.
Usage
var index = indexer(dataDB, indexDB);
index.add('typeIndex', function(key, value) {
return value.type;
});
db.put('0', {type: 'cookie', author: { name: 'cat' }}, function(err) {
if(err) return console.error(err);
index.get('typeIndex', 'cookie', function(err, key, value) {
if(err) return console.error(err);
console.log("key:", key, "value:", value);
});
});
See examples/
for details.
If your index function is async, then call .add
with the async option set:
index.add('foo', {async: true}, function(key, value, cb) {
// do your async work here
cb(null, "index_key");
});
You can also add simple indexes on properties:
index.add('typeIndex', 'type');
Or even simpler if you want to name them the same as the property:
index.add('type');
Property paths are supported:
index.add('author.name');
// or
index.add('myIndex', 'author.name');
and you can create multiple property indexes in one go:
index.add(['type', 'author.index'])
API
.indexer(db, idb, [opts])
The constructor.
- db: The leveldb or sublevel containing your data.
- idb: The leveldb or sublevel to use for index storage.
Opts:
rebuild: false // force rebuild on init
.add(indexName, [opts], indexFunction)
Add a new index. This function is synchronous.
- indexName: Name of index
- indexFunction: Function that returns the index key
Opts:
async: false // set to true if indexFunc uses a callback
The indexFunction will receive the arguments like so:
indexFunction(key, value, cb); // cb only present if .add called with {async: true}
For {async: false} the indexFunction must return the index key. For {async: true} the callback must be called with the index key as the second argument and potential errors or null/undefined as the first argument.
If no index should be created for the current db key/value pair then the index key returned by indexFunction must be either undefined
or null
.
.add(indexName, indexProperty)
TODO not implemented
Add a new index. This function is synchronous.
- indexName: Name of index
- indexProperty: Name of property to index by.
indexProperty can be a path, e.g. creator.name
.
.add(indexProperty)
Add a new index. This function is synchronous.
- indexProperty: Name of property to index by.
indexProperty can be a path, e.g. creator.name
.
The created index will use indexProperty as its name.
.add(indexPropertyArray)
TODO not implemented
Same as above but takes an array of property names or paths and creates indexes for all of them.
.get(indexName, indexKey, cb)
Use an index to fetch an item from the database.
- indexName: Name of the index to use.
- indexKey: The key in the index.
cb is called like cb(err, key, value)
where key and value are the key and value from the actual db (not the index db).
.createReadStream(indexName, opts)
Like the levelup .createReadStream
function this returns a stream of keys and values from the actual db but the order and range are based on the specified index.
.del(indexName, cb)
Delete an index. Like .clear but also makes index-level forget the index.
.clear(indexName, cb)
Clear an index. Deletes all of the index's data in the index db.
.clearAll(cb)
Run .clear for all indexes.
.build(indexName, cb)
Build an index from scratch.
Note: You will likely want to .clear the index first or call .rebuild instead.
.buildAll(cb)
Run .build for all indexes.
.rebuild(indexName, cb)
Clear and then build an index.
.rebuildAll(cb)
Call .rebuild for all indexes.
TODO
- Unit tests
- Add option to return a leveldown
License and copyright
License: AGPLv3
Copyright 2016 BioBricks Foundation