-
Notifications
You must be signed in to change notification settings - Fork 3
/
package.json
48 lines (48 loc) · 12 KB
/
package.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
{
"name": "queryable",
"version": "0.3.7",
"_id": "[email protected]",
"description": "Nosql database that supports subset of mongodb operators",
"main": "queryable.js",
"directories": {
"example": "examples"
},
"files": [
"examples",
"queryable.js",
"README.md",
"package.json"
],
"scripts": {
"test": "cd examples; node ./unit_tests.js; node ./unit-min.js;"
},
"repository": {
"type": "git",
"url": "https://github.com/gmn/queryable.git"
},
"homepage": "http://github.com/gmn/queryable",
"keywords": [
"nosql",
"sqlite",
"nosqlite",
"mongolite",
"database",
"mongodb",
"json",
"db"
],
"author": {
"name": "Greg Naughton",
"email": "[email protected]"
},
"license": "MIT",
"bugs": {
"url": "https://github.com/gmn/queryable/issues"
},
"private": false,
"engines": {
"node": "0.10.x"
},
"readmeFilename": "README.md",
"readme": "Queryable JS\n------------\n\nQueryable - A tiny, single file database written in Javascript, that emulates a functional subset of mongodb commands. It works in both browser and server. The database itself is stored as a json string. Unlike mongo there are no collections; a separate db is simply returned by each call to open(). Essentially, queryable facilitates structured querying of an array of objects.\n\n\n## Examples\n\n### Some examples of using queryable.js in node.js:\n\n```js\nvar queryable = require( 'queryable' );\n\n// There are multiple ways to open a db.\n// The simplest is to provide a full path to where you want your database file.\nvar db = queryable.open( \"~/code/mydata.db\" );\n\n// ..or you can simply name it, which will start an empty db with this name:\nvar db = queryable.open( \"Database_Name\" ); \n\n// You can load from a json object that is an Array of Objects.\nvar db = queryable.open( {db_name:\"name\",data: [{key:val,key2:val2},{key:val},...] } );\n\n// insert any type of key:value pairs you want\ndb.insert( {key:\"keys can be Anything\", comment:\"fields don't have to match\"} );\n\n// Like collections, many independent db can be open at the same time\nvar db2 = queryable.open( \"~/another.db\" );\n\n// It handles any value types\ndb2.insert( {subarray:[1,2,'buckle',{'my':'shoe'}]} );\n\n// find() works like Mongo; RegExp's are fine\nvar res = db.find( {key:/regex/} );\n\n// SELECT * WHERE (age = 40);\nvar res = db.find( {age:40} );\n\n// all rows where age is over 40\n// supports: $gt, $lt, $gte, $lte, $ne, $exists\nvar res = db.find( {age: {'$gt':40}} );\n\n// the first 10 rows where age is over 40 and 'name' exists, sorted by name\nvar res = db.find({age:{$gt:40},name:{'$exists':true}}).sort({name:1}).limit(10);\n\n// find() returns db_result, which has a length property and rows[] array\n// as well as chainable methods like: .sort(), .limit(), .skip(), ..\nconsole.log( 'got ' + res.length + ' rows' );\n\n\n/*\n * a real example - populate from string\n */\n// literal data can be a string or an object \nvar json_string = '[\n {\"name\":\"Cathy\"},\n {\"name\":\"Carol\",\"sex\":\"f\"},\n {\"name\":\"John\",\"sex\":\"m\"},\n {\"name\":\"Cornelius\",\"sex\":\"m\"}]';\n\nvar queryable = require('queryable');\n\nvar db = queryable.open({db_name:\"MyDatabase\",data:json_string}); \n\n// delete a row\ndb.remove({name:'Cathy'});\n\n// get names that start with 'C'\ndb.find({name:/^C/}, function(res) {\n console.log( db.db_name + ' contains these names that start with C:' );\n res.rows.forEach(function(x){\n console.log(' ' + x.name);\n });\n});\n\n/* outputs:\nMyDatabase contains these names that start with C:\n Carol\n Cornelius\n*/\n```\n\nCallbacks work now too (finally):\n\n```js\n db.distinct('name',{age:{$lte:35}},function(res) {\n res.rows.forEach(function(row){\n console.log( row.name );\n });\n });\n```\n\nSee the 'examples' folder for more examples of usage.\n\n## Install\nTo install using npm: \n\n```\nnpm install queryable\n```\nTo install in your project, appending to your project's `package.json`: \n\n```\nnpm install queryable --save\n```\n\nTo install using git:\n\n```\n~$ git clone https://github.com/gmn/queryable.git\n```\n\n## Test\n\nTo run unit-tests: \n\n```\nnpm test\n```\n\n\n## API\n\n### The queryable.open() function\nThere are essentially 3 forms of open(): no args, a single string, a single object. The most concise way to specify what you want is to use a `config` object, and specify each param individually. Failing that, merely providing a fullpath string, where you want your database to live, is sufficient in most cases.\n\n#### queryable.open()\n* `db_name` = defaults to '*test.db*' in node, '*queryable*' in web browser\n* `db_dir` = default is current working directory: (eg. /home/kooldude)\n* `db_path` = concatenation of: (db_dir + db_name) (eg. /home/kooldude/test.db)\n\n#### queryable.open(string)\n* First it tries string as a fullpath; if file is found: `db_name`, `db_dir`, and `db_path` are set.\n* If a file isn't found, it tries string as a directory where it will create the database using the default `db_name`.\n* If it isn't a directory or an existing file, string is assumed to be a fullpath where the file will be saved to. `db_path`, `db_dir`, and `db_name` are set from that.\n\n#### queryable.open(object)\nIf argument is an object, these configuration variable are looked for in it:\n* **db_name** If none supplied, it either takes one from db_path or defaults to '*queryable*' or '*test.db*' in the browser or in node respectively.\n* **db_path** The fullpath where the database lives. Irrelevant in the browser. The database file is written to db_path everytime save() is called, and read from it in open() if an existing file is discovered at the location.\n* **db_dir** Defaults to current working directory if db_path or db_dir are not supplied.\n* **use_gzip** Can manually specify file is of type gzip. This is useful for files lacking the '.gz' extension. Note: currently gzbz must be present for this to work.\n* **data** If this is set, the database can be populated outright by an argument to data. data can be string or json. It must be in the form of an **Array of Zero or More Objects of Any Kind**.\n\n\n## Full List of Commands\n\n### Supported Methods\n| *object* | command | status | comment/example |\n| --- | --- | --- | --- |\n| **queryable** | | | the return of `require('queryable')` |\n| | `open();` | implemented | returns db_object |\n| | `useGzip(boolean);` | implemented | force use of gzip. Useful for gzipped files lacking '.gz' extension; defaults to false |\n| **db_object** | | | the return of `queryable.open()` |\n| | `save()` | implemented | writes to current system (either file-system or browser) |\n| | `insert(vals_obj)` | implemented | inserts vals_obj onto end of table; if vals_obj is an array, will treat contents as array of objects and insert each, one at a time |\n| | update(match, newval) | implemented | finds rows that match `match` and set to `newval` |\n| | `find(match, callback)` | implemented | returns db_result unless callback is present, then db_result passed to it |\n| | `distinct(string,clause)` | implemented | finds all rows, eliminates duplicate values of certain key. `db.distinct('name')` or `db.distinct('name',{age:{$lt:35}})` |\n| | `remove()` | implemented | `db.remove( {name:/[A-Z](.*)/} )` |\n| | `get_json()` | implemented | returns json string of entire db |\n| | `print(fmt)` | implemented | spits out tabular json to stdout |\n| | `now()` | implemented | returns Date().toISOString of the present moment; useful for date fields |\n| | `toDate(arg)` | implemented | returns new Date(arg) |\n| | `count()` | implemented | returns table length |\n| **db_result** | | | |\n| | `sort()` | implemented | |\n| | `limit(integer)` | implemented | limits the result set to `integer` results |\n| | `skip(integer)` | implemented | shaves off the first `integer` rows of the result set |\n| | `count()` | implemented | returns length of result set |\n| | `getArray()` | implemented | |\n| | `get_json()` | implemented | |\n| | `print(fmt)` | implemented | debug print to stdout |\n\n### Query Operators\n| Name | Status | comment/example |\n| --- | --- | --- |\n| $gt | implemented | `db.find( {a:{$gt:5} );` |\n| $gte | implemented | `db.find( {a:{$gte:100} );` |\n| $in | *not impl* | selects the documents where a field equals any value in an array |\n| $lt | implemented | |\n| $lte | implemented | |\n| $ne | implemented | Matches all values that are not equal to the value specified in the query `db.find( {a:{$ne:2},b{$ne:3}} ); // select * from table where (a != 2) && (b != 3)` | \n| $nin | *not impl* | |\n| | | |\n| $or | implemented | `db.find( {$or:[{n:1},{y:{$gte:3}}]} ) //return all results where (n == 1) or (y >= 3)` |\n| $and | *not impl* | |\n| $not | *not impl* | |\n| $nor | *not impl* | |\n| | | |\n| $exists | implemented | `db.find( {name: {$exists:true} } ) // return all results where the name field exists` |\n| $type | *not impl* | |\n| | | |\n| $mod | no plans | |\n| $regex | no plans | |\n| $text | no plans | |\n| $where | no plans | |\n\n### Update Operators\n| Name | Status | comment/example |\n| --- | --- | --- |\n| $inc | *not impl* | Increments the value of the field by the specified amount. |\n| $mul | *not impl* | Multiplies the value of the field by the specified amount. |\n| $rename | *not impl* | Renames a field. |\n| $setOnInsert | *not impl* | Sets the value of a field upon document creation during an upsert. Has no effect on update operations that modify existing documents. |\n| $set | implemented | Sets the value of a field in an existing document. |\n| $unset | *not impl* | Removes the specified field from an existing document. |\n| $min | *not impl* | Only updates if the existing field value is less than the specified value. |\n| $max | *not impl* | Only updates if the existing field value is greater than the specified value. |\n| $currentDate | *kindof impl* | Use **db.now()** instead for now |\n\n\n## In the Works\n1. Better documentation (still working on it); Website (not quite yet).\n \n2. Feature Roadmap: which features will be implemented next, roughly in order.\n * [X] better documentation for open() \n * [X] callbacks\n * [] .findOne() \n * [] better documentation for update() \n * [] $in, $nin\n * [] $and, $not, $nor\n * [] $inc, $mul \n * [] $unset \n * [] $rename \n * [] update().limit()\n * [] remove().limit()\n * [] $min, $max\n * [] $currentDate (db.now() already accomplishes this, though could alias it to $currentDate)\n * [] queryable.min.js\n * [] cleanup\n\n3. Sample projects built on queryable demonstrating features and functionality.\n * [Simple Browser Example](http://naughton.org/queryable-demo/) (sourceode [here](https://raw.githubusercontent.com/gmn/queryable/master/examples/browser.html))\n * [Arcane Vocabulary Tutor](http://lit-tundra-5131.herokuapp.com/)\n\n\n## License\n(The MIT License)\n\nCopyright 2014 Greg Naughton. All rights reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 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 IN THE SOFTWARE.\n\n\n## Contact \nMail: [email protected] for questions, comments, bugs\n"
}