Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Mockgoose/Mockgoose
THIS PACKAGE IS NOW DEPRECATED. Consider using mongodb-memory-server instead
https://github.com/Mockgoose/Mockgoose
Last synced: 2 months ago
JSON representation
THIS PACKAGE IS NOW DEPRECATED. Consider using mongodb-memory-server instead
- Host: GitHub
- URL: https://github.com/Mockgoose/Mockgoose
- Owner: Mockgoose
- License: mit
- Created: 2016-08-02T15:15:23.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T06:19:33.000Z (about 2 years ago)
- Last Synced: 2024-10-29T23:23:14.853Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 696 KB
- Stars: 261
- Watchers: 8
- Forks: 43
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
## Warning: This package has been deprecated! Consider using mongodb-memory-server instead.
[](https://travis-ci.org/Mockgoose/Mockgoose)
Please Share on Twitter if you like #mockgoose
## What is Mockgoose?
Mockgoose provides test database by spinning up mongod on the back when mongoose.connect call is made. By default it is using in memory store which does not have persistence.
## Install
To install the latest official version, use NPM:
```bash
npm install mockgoose --save-dev
```
## Usage
You simply require Mongoose and Mockgoose and wrap Mongoose with Mockgoose.
```javascript
var mongoose = require('mongoose');
var Mockgoose = require('mockgoose').Mockgoose;
var mockgoose = new Mockgoose(mongoose);
mockgoose.prepareStorage().then(function() {
// mongoose connection
});
```
Once Mongoose has been wrapped by Mockgoose connect() will be intercepted by Mockgoose so that no MongoDB instance is created.
## Mocha
Default mocha timeout is 2000ms, change it to two minutes.
```bash
mocha --timeout 120000
```
Same can be done by creating 'mocha.opts' file in your test directory with "--timeout 120000" entry.
### Example
```javascript
var Mongoose = require('mongoose').Mongoose;
var mongoose = new Mongoose();
var Mockgoose = require('mockgoose').Mockgoose;
var mockgoose = new Mockgoose(mongoose);
before(function(done) {
mockgoose.prepareStorage().then(function() {
mongoose.connect('mongodb://example.com/TestingDB', function(err) {
done(err);
});
});
});
describe('...', function() {
it("...", function(done) {
// ...
done();
});
});
```
## ES6 Example without mocha
```javascript
import * as mongoose from 'mongoose';
import {Mockgoose} from 'mockgoose';
let mockgoose: Mockgoose = new Mockgoose(mongoose);
mockgoose.prepareStorage().then(() => {
mongoose.connect('mongodb://foobar/baz');
mongoose.connection.on('connected', () => {
console.log('db connection is now open');
});
});
```
## Helper methods and variables (mockgoose.helper)
### reset(callback)
Reset method will remove **ALL** of the collections from a temporary store,
note that this method is part of **mockgoose** object, and not defined under
**mongoose**
```javascript
mockgoose.helper.reset().then(() => {
done()
});
```
### isMocked
Returns **TRUE** from **mongoose** object if Mockgoose is applied
```javascript
if ( mockgoose.helper.isMocked() === true ) {
// mongoose object is mocked
}
```
### setDbVersion(mongoDBVersion: string)
Set version of MongoDB release
```javascript
import * as mongoose from 'mongoose';
import {Mockgoose} from 'mockgoose';
let mockgoose: Mockgoose = new Mockgoose(mongoose);
mockgoose.helper.setDbVersion("3.2.1");
mockgoose.prepareStorage().then(() => {
mongoose.connect('mongodb://foobar/baz');
mongoose.connection.on('connected', () => {
console.log('db connection is now open');
});
});
```
### setProxy(proxy: string)
Set proxy for downloading MongoDB release
```javascript
import * as mongoose from 'mongoose';
import {Mockgoose} from 'mockgoose';
let mockgoose: Mockgoose = new Mockgoose(mongoose);
let proxy: string = process.env.http_proxy || 'http://example.com:8080';
mockgoose.helper.setProxy(proxy);
mockgoose.prepareStorage().then(() => {
mongoose.connect('mongodb://foobar/baz');
mongoose.connection.on('connected', () => {
console.log('db connection is now open');
});
});
```
## Development
This section contains instructions for developers working on the Mockgoose codebase.
It is not relevant if you just want to use Mockgoose as a library in your project.
### Pre-requisites
* Node.js >= 6
### Setup
```bash
git clone [email protected]:Mockgoose/Mockgoose.git
cd Mockgoose
npm install
npm test
```