An open API service indexing awesome lists of open source software.

https://github.com/instafluff/comfymongodb

Easiest way to setup MongoDB! Run a full-fledged MongoDB server with one line of code. No download or setup. Just, require("comfy-mongo")();
https://github.com/instafluff/comfymongodb

Last synced: 11 months ago
JSON representation

Easiest way to setup MongoDB! Run a full-fledged MongoDB server with one line of code. No download or setup. Just, require("comfy-mongo")();

Awesome Lists containing this project

README

          

# ComfyMongoDB
Easiest way to setup MongoDB! Run a full-fledged MongoDB server with one line of code. No download or setup. Just, `require("comfy-mongo")();`

For those of us that don't want to download and install MongoDB on the computer or for those who need a self-contained version inside a limited directory, **ComfyMongoDB** lets you start up a full MongoDB service ***SUPER EASILY*** in just one line of code.

## Instafluff ##
> *For more coding fun like this Comfy MongoDB Module, come and hang out with us at the Comfiest Corner on Twitch!*

> https://twitch.tv/instafluff

> https://twitter.com/instafluffTV

## Instructions ##
1. Install `comfy-mongo`
```
npm install comfy-mongo --save
```
2. Start MongoDB and listen for events
```javascript
var ComfyMongo = require("comfy-mongo")();
ComfyMongo.on( "ready", () => {
console.log( "MongoDB is ready!" );
});
```
3. Connect and use MongoDB
```javascript
var ComfyMongo = require("comfy-mongo")();
ComfyMongo.on( "ready", () => {
console.log( "MongoDB is ready!" );
connectToMongoDB( "mongodb://localhost:27017" );
});

const MongoClient = require('mongodb').MongoClient;
function connectToMongoDB( url ) {
MongoClient.connect( url, { useNewUrlParser: true }, ( err, client ) => {
console.log("Connected successfully to server");
client.close();
});
}
```

### Running MongoDB Globally ###

If you would simply like to run an instance of MongoDB, you can install ComfyMongoDB globally and run a CLI command.

1. Install `comfy-mongo` globally
```
npm install -g comfy-mongo
```
2. Start MongoDB from console
```
comfy-mongo
```

## Connecting to MongoDB ##

The MongoDB server will start on port `27017` and can be connected to with the url: `mongodb://localhost:27017`

For an example connection, take a look at `example.js`!

## Events ##

Currently, the MongoDB events available are:

- **ready**`ComfyMongo.on( "ready", () => {} )`
- MongoDB is ready for connections
- **output**`ComfyMongo.on( "output", ( data ) => {} )`
- Stdout output stream
- **error**`ComfyMongo.on( "error", ( err ) => {} )`
- Stderr output stream
- **close**`ComfyMongo.on( "close", ( code ) => {} )`
- MongoDB has exited/closed with status code

## Supported Platforms ##

ComfyMongoDB currently works in Windows and Mac/OSX.

## MongoDB Version ##

ComfyMongoDB currently runs MongoDB Community Edition v4.0.10

## How to Specify Your Own Database Directory ##

ComfyMongoDB defaults to `./data` for storage.

To specify your own data directory, you can pass the file path in as a parameter:
```javascript
var ComfyMongo = require("comfy-mongo")( "./MyCustomDirectory" );
```