text-db

!Build Sticker

A simple way to store persistent data for node cli tools.

##Why?
I wanted to make something that mimicked HTML5's localStorage API that I could use for Node CLI tools. You can use text-db as a simple way to store persistent key-value pairs. Not exactly what you're looking for? Here are a couple other repos that do similar things: jsop, node-store.

##Installing
Just install it to your module's dependencies with npm install text-db --save and require it with

var db = require('text-db')(directory/to/store/files/in);. Super simple. Text-db will make the directory if it doesn't exist.

##Usage
| Function | What it does |
|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------|
| db.setItem(key,value); | Saves the given key-value pair to persistent file. |
| db.getItem(key); | Returns the value for the given key. Returns undefined if key doesn't exist. |
| db.removeItem(key); | Removes the given key. |
| db.getKeys(); | Returns an array with all the stored keys. |
| db.getLength(); | Returns the number of keys stored. |
| db.getAll(); | Returns an object with all the key-value pairs. One field will be "_keys" which holds all the keys and is not enumerable. |
| db.getStorageFile(); | Returns a path to the file where data is being stored. |
| db.clear(); | Clears the stored data and deletes the file. |
| db.setStorageDir(dir); | Sets the directory to save the data file to. This will delete the current data file, but will copy over any saved data to the new file. |

##Contact
You can open an issue, send me a tweet (@rjun07a), or shoot me an email if you want to get in touch. I'll try to get back to you quickly.