skip to navigation
skip to content

Not Logged In

motor 0.1.2

Non-blocking MongoDB driver for Tornado

Latest Version: 0.2

https://raw.github.com/mongodb/motor/master/doc/_static/motor.png
Info:Motor is a full-featured, non-blocking MongoDB driver for Python Tornado applications.
Author:A. Jesse Jiryu Davis
https://travis-ci.org/mongodb/motor.png

About

Motor presents a Tornado callback-based API for non-blocking access to MongoDB. The source is on GitHub and the docs are on ReadTheDocs.

"Motor uses a clever greenlet-based approach to fully support both synchronous and asynchronous interfaces from a single codebase. It's great to see companies like 10gen produce first-party asynchronous drivers for their products."

Ben Darnell, Tornado maintainer

Issues / Questions / Feedback

Any issues with, questions about, or feedback for Motor should be sent to the mongodb-user list on Google Groups. For confirmed issues or feature requests, open a case on jira in the "MOTOR" project.

Installation

$ pip install motor

Dependencies

Motor works in all the environments officially supported by Tornado. It requires:

  • Unix, including Mac OS X. Microsoft Windows is not officially supported.
  • PyMongo
  • Tornado
  • Greenlet
  • CPython 2.5, 2.6, 2.7, 3.2, or 3.3
  • Although Motor works with PyPy 1.9, limitations with greenlets and PyPy's JIT compiler make PyPy applications that use Motor too slow to use. We eagerly await improvements in PyPy 2.0.

Additional dependencies are:

  • (to generate documentation) sphinx
  • (to run tests) nose

Documentation

You will need sphinx installed to generate the documentation. Documentation can be generated by running python setup.py doc. Generated documentation can be found in doc/build/html/. You can read the current docs at ReadTheDocs.

Testing

The easiest way to run the tests is to install nose and run nosetests in the root of the distribution.

You can run all the tests in Python 3 with python setup.py nosetests. Due to a nose bug, running a subset of the tests in Python 3 is complicated. Build Motor and its tests with Python 3, then cd to the build directory and run nosetests:

$ python3.3 setup.py build --test
using 2to3
including test modules
running build
running build_py
creating build/lib/motor
...
$ cd build/lib
$ nosetests-3.3 test.test_motor_client
 
File Type Py Version Uploaded on Size
motor-0.1.2.tar.gz (md5) Source 2013-10-17 81KB
  • Downloads (All Versions):
  • 153 downloads in the last day
  • 1464 downloads in the last week
  • 6347 downloads in the last month