Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Fix bad GridFS examples.

I incompletely fixed this file in the previous commit.

(cherry picked from commit fcea7da)
latest commit 6339218ef0
A. Jesse Jiryu Davis ajdavis authored

README.rst

Motor

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- 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

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.6 or later, including CPython 3, or PyPy 2.0 or later.

Documentation

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.

Examples

See the examples on ReadTheDocs or Chirp, a dumb Twitter clone.

Testing

Run python setup.py test. Tests are located in the test/ directory. In Python 2.6, unittest2 is automatically installed.

Something went wrong with that request. Please try again.