Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Python

This branch is 1 commit ahead, 469 commits behind master

Starting to a command 'python setup.py synchrotest'

TODO: make this work, especially with Python3, for which it's critical
latest commit 318daa33fe
@ajdavis 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-based API for non-blocking access to MongoDB. The source is on GitHub and the docs are on ReadTheDocs.

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. Please do not e-mail the author directly with issues or questions - you're more likely to get an answer on the list.

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 auto-discover 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.

Examples

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

Testing

The easiest way to run the tests is to install nose and run nosetests or python setup.py test in the root of the distribution. Tests are located in the test/ directory.

Something went wrong with that request. Please try again.