Motor Features

Warning

As of May 14th, 2025, Motor is deprecated in favor of the GA release of the PyMongo Async API. No new features will be added to Motor, and only bug fixes will be provided until it reaches end of life on May 14th, 2026. After that, only critical bug fixes will be made until final support ends on May 14th, 2027. We strongly recommend migrating to the PyMongo Async API while Motor is still supported. For help transitioning, see the Migrate to PyMongo Async guide.

Non-Blocking

Motor is an asynchronous driver for MongoDB. It can be used from Tornado or asyncio applications. Motor never blocks the event loop while connecting to MongoDB or performing I/O.

Featureful

Motor wraps almost all of PyMongo’s API and makes it non-blocking. For the few PyMongo features not implemented in Motor, see Differences between Motor and PyMongo.

Convenient With tornado.gen

The tornado.gen module lets you use coroutines to simplify asynchronous code. Motor methods return Futures that are convenient to use with coroutines.

Configurable IOLoops

Motor supports Tornado applications with multiple IOLoops. Pass the io_loop argument to MotorClient to configure the loop for a client instance.

Streams Static Files from GridFS

Motor can stream data from GridFS to a Tornado RequestHandler using stream_to_handler() or the GridFSHandler class. It can also serve GridFS data with aiohttp using the AIOHTTPGridFS class.