| Info: | Motor is a full-featured, non-blocking MongoDB driver for Python Tornado applications. |
|---|---|
| Author: | A. Jesse Jiryu Davis |
Motor presents a Tornado_callback- or Future-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 MongoDB produce first-party asynchronous drivers for their products."
—Ben Darnell, Tornado maintainer
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.
$ pip install motor
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.6 or later, including CPython 3, or PyPy 2.0 or later.
You will need sphinx installed to generate the documentation. Documentation
can be generated by running cd doc; make html. Generated documentation
can be found in doc/build/html/. You can read the current docs
at ReadTheDocs.
See the examples on ReadTheDocs or Chirp, a dumb Twitter clone.
Run python setup.py test.
Tests are located in the test/ directory.
In Python 2.6, unittest2 is automatically installed.