Third-Party Tools

Django

Even without a Django backend, you can use MongoDB and PyMongo with most of what Django provides. Certain features of Django that require django.db, such as admin, authentication, and sessions, will not work when using only MongoDB.

• Django MongoDB Engine is a MongoDB database backend for Django that supports Django aggregations, atomic updates, embedded objects, Map/Reduce, and GridFS. It allows you to use most of Django's built-in features, including the ORM, admin, authentication, site and session frameworks, and caching. For more information, see the Django MongoDB Engine tutorial.

• Django MongoEngine is a MongoDB backend for Django. The repository also includes an example application. For more information, see the Django MongoEngine documentation.

• Djongo is a connector for using Django with MongoDB as the database backend. With Djongo, you can use the Django Admin GUI to add and modify documents in MongoDB. The Djongo source code is hosted on GitHub, and the Djongo package is on PyPI.

• mango provides MongoDB backends for Django sessions and authentication (bypassing django.db entirely).

Flask

• Flask-MongoAlchemy adds Flask support for MongoDB with MongoAlchemy.

• Flask-MongoKit is a Flask extension to better integrate MongoKit into Flask.

• Flask-PyMongo bridges Flask and PyMongo.

Other Tools

• Log4Mongo is a flexible Python logging handler that can store logs in MongoDB by using normal and capped collections.

• mongobox is a tool to run a sandboxed MongoDB instance from within a Python app.

• mongodb_beaker enables you to use MongoDB as a backend for Beaker's caching and session system. The source is on GitHub.

• MongoLog is a Python logging handler that stores logs in MongoDB by using a capped collection.

• rod.recipe.mongodb is a Buildout recipe for downloading and installing MongoDB.

gevent

PyMongo uses thread and socket functions from the Python standard library. By using gevent, PyMongo can do asynchronous I/O with non-blocking sockets and schedule operations on greenlets instead of threads.

To use gevent with PyMongo, call gevent's monkey.patch_all() method before loading any other modules, as shown in the following example:

# You must call patch_all() *before* importing any other modules
from gevent import monkey
_ = monkey.patch_all()
from pymongo import MongoClient
client = MongoClient()

import signal
def graceful_reload(signum, traceback):
     """Explicitly close some global MongoClient object."""
     client.close()
signal.signal(signal.SIGHUP, graceful_reload)

mod_wsgi

The mod_wsgi package provides an Apache module that implements a WSGI-compliant interface for hosting Python-based web applications on top of the Apache web server.

To run your PyMongo application under mod_wsgi, follow these guidelines:

• Use the WSGIDaemonProcess directive to run mod_wsgi in daemon mode. If your mod_wsgi configuration includes only the WSGIScriptAlias directive, it will run in embedded mode.

• Use the WSGIApplicationGroup %{GLOBAL} directive to ensure your application runs in the daemon's main Python interpreter, rather than a sub-interpreter. This avoids a small cost incurred when decoding BSON in a sub-interpreter.

• Use the WSGIProcessGroup directive to assign each application to a separate daemon. This ensures the applications don't affect each other's state.

The following mod_wsgi configuration shows how to use the preceding directives to run your PyMongo application:

<VirtualHost *>
    WSGIDaemonProcess my_process
    WSGIScriptAlias /my_app /path/to/app.wsgi
    WSGIProcessGroup my_process
    WSGIApplicationGroup %{GLOBAL}
</VirtualHost>

If you have multiple PyMongo applications, put each in a separate daemon in the global application group:

<VirtualHost *>
    WSGIDaemonProcess my_process
    WSGIScriptAlias /my_app /path/to/app.wsgi
    <Location /my_app>
        WSGIProcessGroup my_process
    </Location>
    WSGIDaemonProcess my_other_process
    WSGIScriptAlias /my_other_app /path/to/other_app.wsgi
    <Location /my_other_app>
        WSGIProcessGroup my_other_process
    </Location>
    WSGIApplicationGroup %{GLOBAL}
</VirtualHost>