Skip to content

fs-based leveldown implementation, designed for quick prototyping

License

Notifications You must be signed in to change notification settings

nolanlawson/fsdown

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

fsdown Build Status

Implementation of leveldown that only has fs as a dependency for on-disk storage. Essentially it uses in-memory JSON objects as the backing store, which are then periodically written to disk.

The intended use case is for very very simple database operations that are not designed for a production environment. Instead the idea is that fsdown should be as simple as possible to install and use, while offering reasonably good durability. In particular, it doesn't require any native modules, so npm install fsdown should be fast and reliable. Think of it as a compromise between memdown and leveldown.

Note: not intended for production use. This module contains race conditions which mean that it can lose data if the process is shut down while a database operation is in progress. Furthermore it has synchronous fs operations, so the performance is not great. Use leveldown instead if you need something bulletproof.

This project is intended for use with the level eco-system.

Install

npm install fsdown

Usage

You use this as you would any other "*DOWN" implementation. Refer to the leveldown docs for details.

There is an additional configuration offered, which is directory. directory allows you to specify a directory to write the JSON files to, else .fsdown is used.

var levelup = require('levelup');
var fsdown = require('fsdown');
fsdown.directory = 'my_custom_directory'; // else '.fsdown'
var db = levelup('my_db', {db: fsdown}); // will write to my_custom_directory/my_db.json

Tests

npm test

This will run tests in Node.

Contributors

About

fs-based leveldown implementation, designed for quick prototyping

Resources

License

Stars

Watchers

Forks

Packages

No packages published