This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A nose plugin to facilitate the creation of automated tests that access Mongo Engine structures.

Project Description

Originally based on Mongo Nose ( ). Thanks to: Kapil Thangavelu


Using pip:

pip install nose-mongoengine


The plugin extends the nose options with a few options. The only required options are either --mongoengine or --mongoengine-mongodb-bin to enable the plugin.

  • --mongoengine is required to enable the plugin.
  • --mongoengine-mongodb-bin Allows specifying the path to the mongod binary. If not specified the plugin will search the path for a mongodb binary. If one is not found, an error will be raised.
  • --mongoengine-clear-after-module Optionally clear data in db after every module of tests.
  • --mongoengine-clear-after-class Optionally clear data in db after every class of tests.
  • --mongoengine-mongodb-port can be optionally set, by default the plugin will utilize a a random open port on the machine.
  • --mongoengine-mongodb-scripting Enables the javascript scripting engine, off by default.
  • --mongoengine-mongodb-logpath Stores the server log at the given path, by default sent to /dev/null
  • --mongoengine-mongodb-prealloc Enables pre-allocation of databases, default is off. Modern filesystems will sparsely allocate, which can speed up test execution.

The plugin will up a instance of Mongo Db and create a empty database to use it.

Usage in your test cases

Since this is your model using mongoengine ( ):

# encoding:utf-8 #
from mongoengine import *

class ModelOne(Document):
    int_value1 = IntField()
    int_value2 = IntField()
    boolean_value = BooleanField(required=True, default=False)

    def get_model_one_by_value1(cls, v):
        return ModelOne.objects(int_value1=v)

    def get_model_one_by_boolean_value(cls, v):
        return ModelOne.objects(boolean_value=v)

This is an example using the test nose + nose-mongoengine ( ):

# encoding:utf-8 #
from model_one import ModelOne
from import assert_equals

class TestModelOne(object):

    # This method run on instance of class
    def setUpClass(cls):

        global o1_id, o2_id

        # Create two objects for test
        o1 = ModelOne()
        o1.int_value1 = 500
        o1.int_value2 = 123
        o1.boolean_value = True

        o2 = ModelOne()
        o2.int_value1 = 500
        o2.int_value2 = 900
        o2.boolean_value = False

        # Save the id of objects to match in the test
        o1_id =
        o2_id =

    # This method run on every test
    def setUp(self):
        global o1_id, o2_id
        self.o1_id = o1_id
        self.o2_id = o2_id

    def test_match_with_value1(self):
        find = ModelOne.get_model_one_by_value1(500)
        assert_equals(len(find), 2)
        assert_equals(find[0].id, self.o1_id)
        assert_equals(find[1].id, self.o2_id)

    def test_match_with_boolean_value(self):
        find = ModelOne.get_model_one_by_boolean_value(True)
        assert_equals(len(find), 1)
        assert_equals(find[0].id, self.o1_id)

Run in the command line:

$ nosetests --mongoengine
Ran 2 tests in 0.054s

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
nose-mongoengine-0.2.2.tar.gz (9.4 kB) Copy SHA256 Checksum SHA256 Source Mar 6, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting