https://github.com/bevry/query-engine
QueryEngine provides extensive Querying, Filtering, and Searching abilities for Backbone.js Collections as well as JavaScript arrays and objects
https://github.com/bevry/query-engine
archived backbone-collections backbonejs client-side docpad-project nodejs nosql
Last synced: 2 months ago
JSON representation
QueryEngine provides extensive Querying, Filtering, and Searching abilities for Backbone.js Collections as well as JavaScript arrays and objects
- Host: GitHub
- URL: https://github.com/bevry/query-engine
- Owner: bevry
- License: other
- Created: 2011-07-06T02:32:35.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2023-12-11T09:51:18.000Z (about 2 years ago)
- Last Synced: 2025-09-21T18:50:30.450Z (3 months ago)
- Topics: archived, backbone-collections, backbonejs, client-side, docpad-project, nodejs, nosql
- Language: CoffeeScript
- Homepage: http://bevry.github.io/query-engine/
- Size: 1.26 MB
- Stars: 329
- Watchers: 13
- Forks: 34
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Query-Engine
[](http://travis-ci.org/bevry/query-engine "Check this project's build status on TravisCI")
[](https://npmjs.org/package/query-engine "View this project on NPM")
[](https://npmjs.org/package/query-engine "View this project on NPM")
[](https://david-dm.org/bevry/query-engine)
[](https://david-dm.org/bevry/query-engine#info=devDependencies)
[](https://www.gratipay.com/bevry/ "Donate weekly to this project using Gratipay")
[](http://flattr.com/thing/344188/balupton-on-Flattr "Donate monthly to this project using Flattr")
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QB8GQPZAH84N6 "Donate once-off to this project using Paypal")
[](https://coinbase.com/checkouts/9ef59f5479eec1d97d63382c9ebcb93a "Donate once-off to this project using BitCoin")
[](http://amzn.com/w/2F8TXKSNAFG4V "Buy an item on our wishlist for us")
Query-Engine is a NoSQL and MongoDb compliant query engine. It can run on the server-side with Node.js, or on the client-side within web browsers
QueryEngine provides extensive Querying, Filtering, and Searching abilities for [Backbone.js Collections](http://documentcloud.github.com/backbone/#Collection) as well as JavaScript arrays and objects. The Backbone.js and Underscore dependencies are optional.
## Features
* runs on [node.js](http://nodejs.org/) and in the browser
* supports [NoSQL](http://www.mongodb.org/display/DOCS/Advanced+Queries) queries (like [MongoDB](http://www.mongodb.org/))
* supports filters (applying a filter function to a collection)
* supports search strings (useful for turning search input fields into useful queries)
* supports pills for search strings (e.g. `author:ben priority:important`)
* supports optional live collections (when a model is changed, added or removed, it can automatically be tested against the collections queries, filters, and search string, if it fails, remove it from the collection)
* supports parent and child collections (when a parent collection has a model removed, it is removed from the child collection too, when a parent collection has a model added or changed, it is retested against the child collection)
* actively maintained, supported, and implemented by several companies
## Compatability
Tested and working against:
- No library
- [Backbone](http://backbonejs.org) v0.9.2, v0.9.9, v1.0.0, v1.1.0, v1.1.2
- [Exoskeleton](http://exosjs.com/) v0.5.1, v0.7.0
## Using
- [Interactive Demos](http://bevry.github.io/query-engine/)
- [Complete Documentation](https://learn.bevry.me/queryengine/guide)
## Install
### [NPM](http://npmjs.org/)
- Use: `require('query-engine')`
- Install: `npm install --save query-engine`
### [Browserify](http://browserify.org/)
- Use: `require('query-engine')`
- Install: `npm install --save query-engine`
- CDN URL: `//wzrd.in/bundle/query-engine@1.5.7`
### [Ender](http://ender.jit.su/)
- Use: `require('query-engine')`
- Install: `ender add query-engine`
### Direct
- Use: `window.queryEngine` or `window.QueryEngine` whichever you prefer
- CDN URL: `//bevry.github.io/query-engine/lib/query-engine.js`
## History
[Discover the change history by heading on over to the `HISTORY.md` file.](https://github.com/bevry/query-engine/blob/master/HISTORY.md#files)
## Contribute
[Discover how you can contribute by heading on over to the `CONTRIBUTING.md` file.](https://github.com/bevry/query-engine/blob/master/CONTRIBUTING.md#files)
## Backers
### Maintainers
These amazing people are maintaining this project:
- Benjamin Lupton (https://github.com/balupton)
### Sponsors
These amazing people have contributed finances to this project:
- BugHerd (http://bugherd.com/)
Become a sponsor!
[](https://www.gratipay.com/bevry/ "Donate weekly to this project using Gratipay")
[](http://flattr.com/thing/344188/balupton-on-Flattr "Donate monthly to this project using Flattr")
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QB8GQPZAH84N6 "Donate once-off to this project using Paypal")
[](https://coinbase.com/checkouts/9ef59f5479eec1d97d63382c9ebcb93a "Donate once-off to this project using BitCoin")
[](http://amzn.com/w/2F8TXKSNAFG4V "Buy an item on our wishlist for us")
### Contributors
These amazing people have contributed code to this project:
- [Andrew Shults](https://github.com/andrewjshults) — [view contributions](https://github.com/bevry/query-engine/commits?author=andrewjshults)
- [Benjamin Lupton](https://github.com/balupton) — [view contributions](https://github.com/bevry/query-engine/commits?author=balupton)
- [Farid Neshat](https://github.com/alFReD-NSH) — [view contributions](https://github.com/bevry/query-engine/commits?author=alFReD-NSH)
- [Khalid Jebbari](https://github.com/DjebbZ) — [view contributions](https://github.com/bevry/query-engine/commits?author=DjebbZ)
- [Nicholas Firth-McCoy](https://github.com/nfm) — [view contributions](https://github.com/bevry/query-engine/commits?author=nfm)
[Become a contributor!](https://github.com/bevry/query-engine/blob/master/CONTRIBUTING.md#files)
## License
Licensed under the incredibly [permissive](http://en.wikipedia.org/wiki/Permissive_free_software_licence) [MIT license](http://creativecommons.org/licenses/MIT/)
Copyright © 2012+ Bevry Pty Ltd (http://bevry.me)
Copyright © 2011 Benjamin Lupton (http://balupton.com)