178 lines
8.6 KiB
ReStructuredText
178 lines
8.6 KiB
ReStructuredText
Requirements
|
|
============
|
|
|
|
.. 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 <https://www.mongodb.com/docs/languages/python/pymongo-driver/current/reference/migration/>`_.
|
|
|
|
|
|
The current version of Motor requires:
|
|
|
|
* CPython 3.10 and later.
|
|
* PyMongo_ 4.9 and later.
|
|
|
|
Motor can integrate with either Tornado or asyncio.
|
|
|
|
The default authentication mechanism for MongoDB is SCRAM-SHA-1.
|
|
|
|
Building the docs requires `sphinx`_.
|
|
|
|
.. _PyMongo: https://pypi.python.org/pypi/pymongo/
|
|
|
|
.. _sphinx: https://www.sphinx-doc.org/
|
|
|
|
.. _compatibility-matrix:
|
|
|
|
Compatibility Matrix
|
|
--------------------
|
|
|
|
Motor and PyMongo
|
|
`````````````````
|
|
|
|
+-------------------+-----------------+
|
|
| Motor Version | PyMongo Version |
|
|
+===================+=================+
|
|
| 2.5 | 3.12+ |
|
|
+-------------------+-----------------+
|
|
| 3.0 | 4.1+ |
|
|
+-------------------+-----------------+
|
|
| 3.1 | 4.2+ |
|
|
+-------------------+-----------------+
|
|
| 3.2 | 4.4+ |
|
|
+-------------------+-----------------+
|
|
| 3.3 | 4.5+ |
|
|
+-------------------+-----------------+
|
|
| 3.4 | 4.5+ |
|
|
+-------------------+-----------------+
|
|
| 3.5 | 4.5+ |
|
|
+-------------------+-----------------+
|
|
| 3.6 | 4.9 |
|
|
+-------------------+-----------------+
|
|
| 3.7 | 4.9+ |
|
|
+-------------------+-----------------+
|
|
|
|
Motor and MongoDB
|
|
`````````````````
|
|
|
|
+---------------------------------------------------------------------+
|
|
| MongoDB Version |
|
|
+=====================+=====+=====+=====+=====+=====+=====+=====+=====+
|
|
| | 3.6 | 4.0 | 4.2 | 4.4 | 5.0 | 6.0 | 7.0 | 8.0 |
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| Motor Version | 2.5 | Y | Y | Y | Y | Y |**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.0 | Y | Y | Y | Y | Y |**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.1 | Y | Y | Y | Y | Y | Y |**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.2 | Y | Y | Y | Y | Y | Y | Y |**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.3 | Y | Y | Y | Y | Y | Y | Y |**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.4 | Y | Y | Y | Y | Y | Y | Y |**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.5 | Y | Y | Y | Y | Y | Y | Y | Y |
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.6 | Y | Y | Y | Y | Y | Y | Y | Y |
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.7 | N | Y | Y | Y | Y | Y | Y | Y |
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
|
|
There is no relationship between PyMongo and MongoDB version numbers, although
|
|
the numbers happen to be close or equal in recent releases of PyMongo and MongoDB.
|
|
Use `the PyMongo compatibility matrix`_ to determine what MongoDB version is
|
|
supported by PyMongo. Use the compatibility matrix above to determine what
|
|
MongoDB version Motor supports.
|
|
|
|
.. _the PyMongo compatibility matrix: https://www.mongodb.com/docs/languages/python/pymongo-driver/current/reference/compatibility/
|
|
|
|
Motor and Tornado
|
|
`````````````````
|
|
|
|
Where "N" appears in this matrix, the versions of Motor and Tornado are
|
|
known to be incompatible, or have not been tested together.
|
|
|
|
+---------------------------------------------+
|
|
| Tornado Version |
|
|
+=====================+=====+=====+=====+=====+
|
|
| Motor Version | 2.5 |**N**|**N**| Y | Y |
|
|
+---------------+-----+-----+-----+-----+-----+
|
|
| | 3.0 |**N**|**N**|**N**| Y |
|
|
+---------------+-----+-----+-----+-----+-----+
|
|
| | 3.1 |**N**|**N**|**N**| Y |
|
|
+---------------+-----+-----+-----+-----+-----+
|
|
| | 3.2 |**N**|**N**|**N**| Y |
|
|
+---------------+-----+-----+-----+-----+-----+
|
|
| | 3.3 |**N**|**N**|**N**| Y |
|
|
+---------------+-----+-----+-----+-----+-----+
|
|
| | 3.4 |**N**|**N**|**N**| Y |
|
|
+---------------+-----+-----+-----+-----+-----+
|
|
|
|
Motor and Python
|
|
````````````````
|
|
|
|
Motor 2.5 deprecated support for Python 3.5.
|
|
|
|
Motor 3.0 dropped support for Pythons older than 3.7.
|
|
|
|
Motor 3.1.1 added support for Python 3.11.
|
|
|
|
Motor 3.3 added support for Python 3.12.
|
|
|
|
Motor 3.5 dropped support for Python 3.7 and added support for Python 3.13.
|
|
|
|
Motor 3.7 dropped support for Python 3.8.
|
|
|
|
Motor 3.8 dropped support for Python 3.9 and added support for Python 3.14.
|
|
|
|
+---------------------------------------------------------------------------+
|
|
| Python Version |
|
|
+=====================+=====+=====+=====+=====+=====+=====+=====+=====+=====+
|
|
| | 3.6 | 3.7 | 3.8 | 3.9 | 3.10| 3.11| 3.12| 3.13| 3.14|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| Motor Version | 1.0 | Y |**N**|**N**|**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 1.1 | Y |**N**|**N**|**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 1.2 | Y | Y |**N**|**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 1.3 | Y | Y |**N**|**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 2.0 | Y | Y |**N**|**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 2.1 | Y | Y | Y |**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 2.2 | Y | Y | Y |**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 2.3 | Y | Y | Y |**N**|**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 2.4 | Y | Y | Y | Y |**N**|**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 2.5 | Y | Y | Y | Y | Y |**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.0 |**N**| Y | Y | Y | Y |**N**|**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.1 |**N**| Y | Y | Y | Y | Y |**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.2 |**N**| Y | Y | Y | Y | Y |**N**|**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.3 |**N**| Y | Y | Y | Y | Y | Y |**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.4 |**N**| Y | Y | Y | Y | Y | Y |**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.5 |**N**|**N**| Y | Y | Y | Y | Y |**N**|**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.6 |**N**|**N**| Y | Y | Y | Y | Y | Y |**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.7 |**N**|**N**|**N**| Y | Y | Y | Y | Y |**N**|
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
| | 3.8 |**N**|**N**|**N**|**N**| Y | Y | Y | Y | Y |
|
|
+---------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|
|
|
Not Supported
|
|
-------------
|
|
|
|
Motor does not support Jython or IronPython.
|