aboutsummaryrefslogtreecommitdiff
path: root/node_modules/mongo-factory/README.md
diff options
context:
space:
mode:
authorWaref Haque <warefhaque@Warefs-MacBook-Pro.local>2016-07-17 20:24:49 +0000
committerWaref Haque <warefhaque@Warefs-MacBook-Pro.local>2016-07-17 20:24:49 +0000
commite58943c3e620f05937656fdde032254ae3373f36 (patch)
tree77072aa55efa1753c8c8ae584669cf3589551268 /node_modules/mongo-factory/README.md
parent55098c767afb0b119aaeda330eaedba5c1a87dc3 (diff)
redirect commit
Diffstat (limited to 'node_modules/mongo-factory/README.md')
-rw-r--r--node_modules/mongo-factory/README.md43
1 files changed, 43 insertions, 0 deletions
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!