1. JugglingDB(3)
  2. JugglingDB
  3. JugglingDB(3)

NAME

JugglingDB - cross-database ORM for nodejs and the browser

DESCRIPTION

JugglingDB is a cross-db ORM for nodejs, that provides a common interface to access many popular database engines. JugglingDB Current supports: mysql, sqlite3, postgres, couchdb, mongodb, redis, neo4j and in-memory-storage.

JugglingDB also works client-side (using WebService and Memory adapters), which allows rich client-side apps to talk to application servers using a JSON API.

INSTALLATION

Use npm to install the core package:

npm install jugglingdb --save

Alternatively you can install the jugglingdb core from github:

npm install 1602/jugglingdb

Then install an adapter for specific database, for example for redis jugglingdb-redis:

npm install jugglingdb-redis

See ADAPTERS for a list of available adapters.

DOCUMENTATION

Autogenerated documentation available at jsdoc.info/1602/jugglingdb. Hand written manual sections are:

jugglingdb-schema(3)

Everything about the schema, data types and model definition.

jugglingdb-model(3)

Model methods, features and internals.

jugglingdb-validations(3)

Built-in validators, creating custom validations, syncronous and asyncronous object validation.

jugglingdb-hooks(3)

Hooks and object lifecycle.

jugglingdb-adapter(3)

Adapter API explained.

ADAPTERS

All adapters are available as separate packages at github.com/jugglingdb and published in npm.

CONTRIBUTION

You can take part in improving the jugglingdb codebase and documents. Please make your proposed changes by forking our documentation's repository on github, and then create a new pull request. Please remember that your contribution is highly encouraged. Be sure to follow the discussion in google group and see github issues before you make changes. It's preferable that you post new comment in google group or in github before you make changes and create pull request.

FUTURE

See jugglingdb-roadmap(3) and github issues to catch up current development and see how you can help jugglingdb to grow up.

BUGS

When you find issues, please report them:

github/core
https://github.com/1602/jugglingdb/issues
github/adapters
https://github.com/jugglingdb
email
compoundjs@googlegroups.com

Provide a test case for reproducing your error. When reporting issues to the core, mention which adapter you are using and where problem could be reproduced.

HISTORY

See jugglingdb-changelog(3)

JugglingDB is Copyright (C) 2011 Anatoliy Chakkaev http://anatoliy.in

AUTHOR

CONTRIBUTORS

core contributors (more than 1%)

410 Anatoliy Chakkaev       73.9%
 31 Sebastien Drouyer       5.6%
 25 1602                    4.5%
  9 Muneeb Samuels          1.6%
  6 Henri Bergius           1.1%

adapters maintainers

NOTE: Other adapters waits for their maintainers, drop a line to mail@anatoliy.in if you want to maintain some adapter on regular basis.

SEE ALSO

jugglingdb-schema(3)

  1. 1602 Software
  2. January 2014
  3. JugglingDB(3)