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.

Documentation:

Available at motor.readthedocs.io

Author:

A. Jesse Jiryu Davis

About

Motor presents a coroutine-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

Support / Feedback

For issues with, questions about, or feedback for PyMongo, please look into our support channels. Please do not email any of the Motor developers directly with issues or questions - you’re more likely to get an answer on the MongoDB Community Forums.

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:

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.

Installation

Motor can be installed with pip:

$ pip install motor

Dependencies

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

  • Unix (including macOS) or Windows.

  • PyMongo >=3.11,<4

  • Python 3.5+

See requirements for details about compatibility.

Examples

See the examples on ReadTheDocs.

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.

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-2.3.0.tar.gz (327.3 kB view details)

Uploaded Source

Built Distribution

motor-2.3.0-py3-none-any.whl (53.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: motor-2.3.0.tar.gz
  • Upload date:
  • Size: 327.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.5

File hashes

Hashes for motor-2.3.0.tar.gz
Algorithm Hash digest
SHA256 f1692b760d834707e3477996ce8d407af8cd61c1a2abedbf81c22ef14675e61a
MD5 0946da9969ccb4599fa7df841851988d
BLAKE2b-256 9a4a1ff8f583f768f5a784e4fac4e8edc558e2459175635499bc61c70765bde6

See more details on using hashes here.

File details

Details for the file motor-2.3.0-py3-none-any.whl.

File metadata

  • Download URL: motor-2.3.0-py3-none-any.whl
  • Upload date:
  • Size: 53.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.5

File hashes

Hashes for motor-2.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 428d94750123d19fcd0a89b8671ff9b4656f205217bad9f44161748c64c5fc80
MD5 dea0ecb4b5c6493b40301a0493e89a7b
BLAKE2b-256 7a2c8b09b03f3f96462d6bf06cc4be85c602afc5b79c002990f0d28fd2a385d9

See more details on using hashes here.

Supported by

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