Mongodb-ephemeral-server NPM

About The Project

This project will spin up an mongodb server specified the configuration for the same. This package uses the ephemeral storage for the database content. This means once the database instance is stopped, all data will be lost.

This makes it ideal for testing purpose or even development(if you wish).

Built With

The project is built using a combination of JavaScript and TypeScript.

Getting Started

To install the package simply run the following simple steps

Prerequisites

To run this, please make sure you have to following things installed.

NodeJs - version 12.x+
MongoDB - version 4.2+

Installation

npm
```
npm i mongodb-ephemeral-server
```

Usage

Example code to show the usage of the package:

Import the package in your code:

const mongodbEphemeralServer = require("mongodb-ephemeral-server")

Provide the database configurations:

const PORT = 27025; // Or anything you wish.
const dbPath = '/home/user/mongodb-ephemeral/data'; // Path to your database
const logPath = '/home/user/mongodb-ephemeral/log'; // Path to your database logs
const dbName = 'sample_db_name';
/**
 * In case you want to run test on windows - add the mongodExeLocation
 * Note adding this on linux won't have any effect
 * So, if you have written test on window machine
 * You need not to worry when running on a linux machine
 */
const mongodExeLocation = 'C:/Program Files/MongoDB/Server/4.2/bin'

Create the ephemeral instance:

const ephemeralInstance = new mongodbEphemeralServer(port, logpath, dbpath, mongodExeLocation);

Start the mongodb-ephemeral-server:

ephemeralInstance.start();
const dbUri = ephemeralInstance.getDbUri(dbName);

Connect to the database:

// Connect to the Database using the uri obtained.
// If using the mongoose ODM use the below code:
const { mongoose } = require('mongoose');
await mongoose.connect(dbUri, {});

Close the database connection: (Optional)

// If using the mongoose ODM
await mongoose.connection.close();

Terminate the mongodb-ephemeral-server:
```
ephemeralInstance.stop();
```

For more examples, please refer to the sample project

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!