Motor

About

Motor is a full-featured, non-blocking MongoDB driver for Python asyncio and Tornado applications. Motor presents a coroutine-based API for non-blocking access to MongoDB.

“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

Bugs / Feature Requests

Think you’ve found a bug? Want to see a new feature in Motor? Please open a case in our issue management tool, JIRA:

Create an account and login.
Navigate to the MOTOR project.
Click Create Issue - Please provide as much information as possible about the issue type and how to reproduce it.

Bug reports in JIRA for all driver projects (i.e. MOTOR, CSHARP, JAVA) and the Core Server (i.e. SERVER) project are public.

How To Ask For Help

Please include all of the following information when opening an issue:

Detailed steps to reproduce the problem, including full traceback, if possible.
The exact python version used, with patch level:

python -c "import sys; print(sys.version)"

The exact version of Motor used, with patch level:

python -c "import motor; print(motor.version)"

The exact version of PyMongo used, with patch level:

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, …)

Security Vulnerabilities

If you’ve identified a security vulnerability in a driver or any other MongoDB project, please report it according to the instructions here.

Examples

See the examples on ReadTheDocs.

Documentation

Motor’s documentation is on ReadTheDocs.

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

Learning Resources

MongoDB Learn - Python courses.
Python Articles on Developer Center.

Testing

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

motor