From e58943c3e620f05937656fdde032254ae3373f36 Mon Sep 17 00:00:00 2001 From: Waref Haque Date: Sun, 17 Jul 2016 16:24:49 -0400 Subject: redirect commit --- node_modules/mongo-factory/README.md | 43 ++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 node_modules/mongo-factory/README.md (limited to 'node_modules/mongo-factory/README.md') diff --git a/node_modules/mongo-factory/README.md b/node_modules/mongo-factory/README.md new file mode 100644 index 0000000..81433b5 --- /dev/null +++ b/node_modules/mongo-factory/README.md @@ -0,0 +1,43 @@ +#mongo-factory +[![Build Status](https://travis-ci.org/toymachiner62/mongo-factory.svg?branch=master)](https://travis-ci.org/toymachiner62/mongo-factory) +[![Code Climate](https://codeclimate.com/github/toymachiner62/mongo-factory/badges/gpa.svg)](https://codeclimate.com/github/toymachiner62/mongo-factory) + +> The purpose of this module is to manage mongo connection pools without creating a new connection pool in every file. +> +> You can require this module in as many files as you want and every time you call `mongoFactory.getConnection` it returns +> a connection if one exists for the connection string passed in, or it instantiates the connection pool and +> then returns a connection. + +## Usage + +```js +var mongoFactory = require('mongo-factory'); + +mongoFactory.getConnection('mongodb://localhost:27017') + .then(function(db) { + // Use mongo's "db" object as you normally would. + db.collection.find()... + }) + .catch(function(err) { + console.error(err); + }); +``` + +## API + +#### `getConnection(mongodbConnectionString)` + +The only parameter is a connection string for a MongoDB connection. + +#### `ObjectId` + +Exposes the MongoDB [ObjectID](http://mongodb.github.io/node-mongodb-native/2.0/tutorials/objectid/) function. + +## Contributing + +1. Clone project and run `npm install` +2. Add feature(s) +3. Add tests for it +4. Submit pull request + +Enjoy! -- cgit v1.2.3