Skip to main content

Non-blocking MongoDB driver for Tornado or asyncio

Project description

https://raw.github.com/mongodb/motor/master/doc/_static/motor.png
Info:

Motor is a full-featured, non-blocking MongoDB driver for Python Tornado and asyncio applications.

Author:

A. Jesse Jiryu Davis

About

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

“We use Motor in high throughput environments, processing tens of thousands of requests per second. It allows us to take full advantage of modern hardware, ensuring we utilise the entire capacity of our purchased CPUs. This helps us be more efficient with computing power, compute spend and minimises the environmental impact of our infrastructure as a result.”

David Mytton, Server Density

“We develop easy-to-use sensors and sensor systems with open source software to ensure every innovator, from school child to laboratory researcher, has the same opportunity to create. We integrate Motor into our software to guarantee massively scalable sensor systems for everyone.”

Ryan Smith, inXus Interactive

Installation

$ pip install motor

Dependencies

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

  • Unix, including Mac OS X. Windows is not supported.

  • PyMongo 3.4 or later.

  • Python 2.7 or later.

  • futures on Python 2.7.

  • backports.pbkdf2 for faster authentication with MongoDB 3.0+, especially on Python older than 2.7.8, or on Python 3 before Python 3.4.

See requirements for details about compatibility.

How To Ask For Help

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 in Jira in the “MOTOR” project. Please include all of the following information:

  • Detailed steps to reproduce the problem, including your code and a full traceback, if possible.

  • What you expected to happen, and what actually happened.

  • The exact python version used, with patch level:

    $ python -c "import sys; print(sys.version)"
  • The exact version of PyMongo used:

    $ python -c "import pymongo; print(pymongo.version); print(pymongo.has_c())"
  • The exact Tornado version, if you are using Tornado:

    $ python -c "import tornado; print(tornado.version)"
  • The operating system and version (e.g. RedHat Enterprise Linux 6.4, OSX 10.9.5, …)

Documentation

Motor’s documentation is on ReadTheDocs.

Build the documentation with Python 3.5. Install sphinx, Tornado, and aiohttp, and do cd doc; make html.

Examples

See the examples on ReadTheDocs.

Testing

Run python setup.py test. Tests are located in the test/ directory.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

motor-1.2.4.tar.gz (160.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

motor-1.2.4-py2.py3-none-any.whl (46.8 kB view details)

Uploaded Python 2Python 3

File details

Details for the file motor-1.2.4.tar.gz.

File metadata

  • Download URL: motor-1.2.4.tar.gz
  • Upload date:
  • Size: 160.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for motor-1.2.4.tar.gz
Algorithm Hash digest
SHA256 7d06bcbbbb11c0f7db72066d8ee2ee18c5a4c5cb9537f85e0d34b95b1290784d
MD5 ac9ecccf8790c98f8300a6baa30ee7bd
BLAKE2b-256 914ef26bbac9fae4bcedc30e27782c1930838d6a1bf9825886377fb9cb3fba3c

See more details on using hashes here.

File details

Details for the file motor-1.2.4-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for motor-1.2.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 1522e7b45f08a500dc3c540d2e54aaadbb2784163e6e220574eef6f4f2550927
MD5 c47a812943b518b01afa675d03bc5346
BLAKE2b-256 c600b393bfe5b7703f29a0c266810a3ebc5f6f8dcd8f693618f127f30ca36464

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page