Skip to main content

MongoDB server stub setup

Project description

This package provides a mongodb server stub setup for python doctests.

README

This package provides a mongo database server testing stub. You can simply setup such a mongodb stub server in a doctest like:

import doctest
import unittest

from m01.stub import testing

def test_suite():
    return unittest.TestSuite((
        doctest.DocFileSuite('README.txt',
            setUp=testing.doctestSetUp,
            tearDown=testing.doctestTearDown,
            optionflags=doctest.NORMALIZE_WHITESPACE|doctest.ELLIPSIS),
        ))


if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

The m01/stub/testing.py module provides a start and stop method which will download, install, start and stop a mongodb server. All this is done in the m01/stub/testing/sandbox folder. Everytime a test get started the mongodb/data folder get removed and a fresh empty database get used.

Note: Also see the zipFolder and unZipFile methods in testing.py which allows you to setup mongodb data and before remove them store them as a zip file for a next test run. Such a zipped data folder can get used in another test run by set the path to the zip file as dataSource argument. Also check the m01.mongo package for more test use cases.

Testing

Let’s use the pymongo package for test our mongodb server stub setup. Note we use a different port for our stub server setup (45017 instead of 27017):

>>> from pprint import pprint
>>> import pymongo
>>> from pymongo.periodic_executor import _shutdown_executors
>>> conn = pymongo.MongoClient('mongodb://127.0.0.1:45017')

Let’s test our mongodb stub setup:

>>> pprint(conn.server_info())
{...,
 u'ok': 1.0,
 ...}
>>> conn.database_names()
[u'admin', u'local']

setup an index:

>>> conn.testing.test.collection.ensure_index('dummy')
u'dummy_1'

add an object:

>>> _id = conn.testing.test.save({'__name__': u'foo', 'dummy': u'object'})
>>> _id
ObjectId('...')

remove them:

>>> conn.testing.test.remove({'_id': _id})
{...}

and check the database names again:

>>> conn.database_names()
[u'admin', u'local', u'testing']

Let’s drop the database:

>>> conn.drop_database("testing")
>>> conn.database_names()
[u'admin', u'local']

Close client:

>>> conn.close()
>>> _shutdown_executors()

CHANGES

3.1.0 (2018-01-29)

  • bugfix: support different download urls for windows. Not every option is released. We will try different urls for windows 64 bit versions. Note, you will probably run into a MemoryError during download if your try to download a large mongodb release with a non 64 bit python version.

3.0.1 (2015-11-10)

  • support pymongo >= 3.0.0 and use 3.0.0 as package version and reflect pymongo >= 3.0.0 compatibility

3.0.0 (2015-09-28)

  • pymongo > 3.0.0 compatibility. Support pymongo > 3.0.0 use MongoClient instead of Connection etc. Use 3.0.0 as package version and reflect pymongo > 3.0.0 compatibility.

  • switch default mongodb download version to 3.0.6

  • improve shutdown mongodb server, cleanup client weakref

0.5.8 (2015-03-17)

  • update default mongodb version to 2.4.10

  • changed default mongodb allocation space from 100MB to 10MB for faster server startup

  • bugfix: startup check didn’t fit and it was forced 16 times to sleep for one second. Fix server status ok check from ‘1.0’ to 1

0.5.7 (2012-12-10)

  • bugfix: didn’t shutdown with sleep lower the 1

  • improve server setup, use unique log files for each startup

  • run tests with pymongo 2.4.1

0.5.6 (2012-12-09)

  • switch to mongodb 2.2.2 and support version property in startMongoServer

0.5.5 (2012-11-18)

  • bugfix: fix start and stop observer methods. Replaced javascript calls with simpler pymongo connectionn calls for startup check and shutdown

0.5.4 (2012-11-18)

  • update to mongodb 2.2.0

  • switch to bson import

  • force 64 bit download by default

  • use “sleep” value only for files and directories, use flexible wait for process

  • bugfix: mongo results comes back with a line break

  • bugfix: string cmd only on Windows

  • use shell=False to start mongodb, even on posix (safer). This changes the “options” argument: it has to be a list now

  • to stop mongodb, we are now sending a command through the “mongo shell”, we do not use a pid file any more, all we need is the port, which we keep in a global

  • we are now repeatedly checking till the mongodb server starts up and answers to an admin query

  • move flexible sub-version tests to accomodate OpenBSD

  • fixed detection of being on a Mac for mongo db download for tests

  • added MANIFEST.in file

0.5.3 (2011-08-26)

  • Fix 32bit linux download (Albertas)

  • Remove temp files after download

  • Fix 64bit linux

0.5.2 (2011-08-24)

  • Still fixing on linux

0.5.1 (2011-08-24)

  • fix on linux

0.5.0 (2011-08-19)

  • initial release tested on win 32bit. NOT tested on win 64bit, mac 32/64bit and posix 32/64bit systems. Please report if something doesn’t work on this systems.

Project details


Download files

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

Source Distribution

m01.stub-3.1.0.tar.gz (14.8 kB view details)

Uploaded Source

File details

Details for the file m01.stub-3.1.0.tar.gz.

File metadata

  • Download URL: m01.stub-3.1.0.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for m01.stub-3.1.0.tar.gz
Algorithm Hash digest
SHA256 a4745bc50de8306cd034482e22eeda82953b2c4182c2b8fcf10b79eebade6be1
MD5 bef97f7b8596314bf3c1223036a37904
BLAKE2b-256 a1a759d11b2d98df667d966e057db346763e8e9178a5f35cd038e21846fc0db0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page