Needs maintainer, or friend with motivation!
I've been busy a lot with work -- and this project while very small has still managed to generate some attention, the problem? A couple years ago I got tricked into thinking I'd found a new, better version of JavaScript, CoffeeScript, I was wrong. There's many optimizations I see now that I should have made then... So, well this project has become something of an eye sore for me and I would either like someone else who has the free time to take on this project or someone whose interested in working on a refactor with me.
nedb)
restify-nedb (forrestify-nedb
was built to give you restful api resources for client side application frameworks like angular.js
, ember.js
, backbone.js
or knockout.js
as well as give you a simple file/memory based cache utilizing nedb. (ps, i love nedb, you should too.) If you haven't already checked it out, maybe you want to use it separate of all of this extra stuff, do it. It's like sqlite, with a subset of mongodb's api. Really neat.
Features
- Super fast
nedb
file/memory backed cache w/ simple garbage collection - 100% coffeescript, hate it or love it
- restful routing:
GET
,POST
,PUT
,DELETE
- parses
json/multi-part
- Let me know if you have any issues, please open issues/prs etc, it's a lot more fun that way
Installation
npm install restify-nedb --save
Example
var express = ;var app = ;var server = ; app; app;app;app; var restify = mount;var config = config; var path = ; // some sample middlware to throw at itvar { console; return ;}; // default config optionsvar opts = filePath: path maxAge: 1000 * 60 * 60 prefix: '/session' middleware: sampleMiddleware; // initialize our config object cfg = opts; // if you aren't already using an nedb// instance, then calling this will create// one for you. // accepts sync/blocking // cfg.makeDataStore(); // api = new restify(cfg, app); // or async <3 cfg; server;
Configuration Options
Options | Defaults | Type | Infos |
---|---|---|---|
ds | internal |
DataStore | allow for outside nedb processes to be restified. tip: config.ds() returns a new DataStore with whatever your opts are set to, once it's fired it will internalize and share |
prefix | /ds |
String | defines the first route path, for instance http://localhost:3000/ds |
version | /v1 |
String | not preferred, as a rule i feel these aren't the best idea for your api, last thing you want is fragmentation in your api |
exclude | [] |
Array | excludes keys/values from the api, good for things like password |
middleware | [] |
Array | middlewares, ie passport authentication, logging, analytics |
memoryStore | false |
Boolean | whether or not keep an in-memory store or a file based persistant store, defaults to false , we like persistant files. |
fileName | nedb-filestore.db |
String | file name for your nedb filestore |
filePath | ../db |
String | bit easier to change the path and view the contents instead of digging through node_modules |
maxAge | 1000 * 60 * 60 |
Number | if set to null or false automated gc will be disabled |
store | undefined |
String | not currently working - will allow for multiple nedb collections, still working out the kinks. |
Routes
config.makeDataStore(err?, callback?)
- accepts either sync/async flow, if you don't have an
nedb
instance going, use this to create one -- otherwise pass it into your options object.
Ordering
?limit=20
GET http://localhost:3000/session/v1?limit=20
if (limit=20)
then it will only return 20 objects, etc.
?skip=10
GET http://localhost:3000/session/v1?skip=10
- skip fields, good for paging
?sort=val
GET http://localhost:3000/session/v1?sort=val
- sort doc in ascending
?sort=-val
GET http://localhost:3000/session/v1?sort=-val
- sort doc in descending order
Query / Searching
?key=value
GET http://localhost:3000/session/v1?key=value
- queries matching key/values
Defaults
GET http://localhost:3000/session/v1POST http://localhost:3000/session/v1 GET http://localhost:3000/session/v1/:idPUT http://localhost:3000/session/v1/:idDELETE http://localhost:3000/session/v1/:id GET http://localhost:3000/session/v1?id=:idPUT http://localhost:3000/session/v1?id=:id
Additional
?append=true
PUT http://localhost:3000/session/v1/:id?append=true
- append defaults to false. Set to true to do something similar to
findAndUpdate
_stale
override
POST / PUT http://localhost:3000/session/v1
- passing
_stale
in your body/json will act as an override tostale
, say you need some things to last longer/shorter than other cached items
Tests
npm test
Cake tools
cake build:docs
will build annotated source code documentation from doccocake build:coffee
will compile coffee from/src
to js in/lib
Pro-tips
- I would recommend using something like Advanced REST Client for testing, it'll help.
License
The MIT License (MIT) Copyright (c) 2013 David Higginbotham Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included inall copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS INTHE SOFTWARE.