level-blobs

Save binary blobs in level and stream then back. Similar to level-store but streams2 and with support for random access writes and reads

npm install level-blobs

Usage

1var blobs = require('level-blobs');
2var level = require('level');
3
4var db = level('/tmp/my-blobs-db');
5var bl = blobs(db);
6
7// create a write stream
8var ws = blobs.createWriteStream('my-file.txt');
9
10ws.on('finish', function() {
11	// lets read the blob and pipe it to stdout
12	var rs = blobs.createReadStream('my-file.txt');
13	rs.pipe(process.stdout);
14});
15
16ws.write('hello ');
17ws.write('world');
18ws.end();

API

blobs(db, opts)

Create a new blobs instance. Options default to

1{
2	blockSize: 65536, // byte size for each block of data stored
3	batch: 100        // batch at max 100 blocks when writing
4}

bl.createReadStream(name, opts)

Create a read stream for name. Options default to

1{
2	start: 0       // start reading from this byte offset
3	end: Infinity  // end at end-of-file or this offset (inclusive)
4}

bl.createWriteStream(name, opts)

Create a write stream to name. Options default to

1{
2	start: 0       // start writing at this offset
3	               // if append === true start defaults to end-of-file
4	append: false  // set to true if you want to append to the file
5	               // if not true the file will be truncated before writing
6}

bl.read(name, opts, cb)

Create a read stream and buffer the stream into a single buffer that is passed to the callback. Options are passed to createReadStream.

bl.write(name, data, opts, cb)

Write data to name and call the callback when done. Options are passed to createWriteStream.

bl.remove(name, cb)

Remove name from the blob store

License

MIT