From 4f1962faf277e04e89a730fb820235eba325810c Mon Sep 17 00:00:00 2001 From: Noah Stapp Date: Thu, 26 Jun 2025 10:08:37 -0400 Subject: [PATCH] MOTOR-1469 - Update the wording of Motor Deprecation Message (#339) --- README.md | 9 +++++---- doc/api-asyncio/aiohttp.rst | 8 +++++--- doc/api-asyncio/asyncio_gridfs.rst | 8 +++++--- doc/api-asyncio/asyncio_motor_change_stream.rst | 8 +++++--- doc/api-asyncio/asyncio_motor_client.rst | 8 +++++--- doc/api-asyncio/asyncio_motor_client_encryption.rst | 8 +++++--- doc/api-asyncio/asyncio_motor_client_session.rst | 8 +++++--- doc/api-asyncio/asyncio_motor_collection.rst | 8 +++++--- doc/api-asyncio/asyncio_motor_database.rst | 8 +++++--- doc/api-asyncio/cursors.rst | 8 +++++--- doc/api-asyncio/index.rst | 8 +++++--- doc/api-tornado/cursors.rst | 8 +++++--- doc/api-tornado/gridfs.rst | 8 +++++--- doc/api-tornado/index.rst | 8 +++++--- doc/api-tornado/motor_change_stream.rst | 8 +++++--- doc/api-tornado/motor_client.rst | 8 +++++--- doc/api-tornado/motor_client_encryption.rst | 8 +++++--- doc/api-tornado/motor_client_session.rst | 8 +++++--- doc/api-tornado/motor_collection.rst | 8 +++++--- doc/api-tornado/motor_database.rst | 8 +++++--- doc/api-tornado/web.rst | 8 +++++--- doc/changelog.rst | 8 +++++--- doc/configuration.rst | 8 +++++--- doc/developer-guide.rst | 8 +++++--- doc/differences.rst | 8 +++++--- doc/examples/aiohttp_gridfs_example.rst | 8 +++++--- doc/examples/authentication.rst | 8 +++++--- doc/examples/bulk.rst | 8 +++++--- doc/examples/encryption.rst | 8 +++++--- doc/examples/index.rst | 8 +++++--- doc/examples/monitoring.rst | 8 +++++--- doc/examples/tailable-cursors.rst | 8 +++++--- doc/examples/timeouts.rst | 8 +++++--- doc/examples/tornado_change_stream_example.rst | 8 +++++--- doc/examples/type_hints.rst | 8 +++++--- doc/features.rst | 8 +++++--- doc/index.rst | 8 +++++--- doc/installation.rst | 8 +++++--- doc/migrate-to-motor-2.rst | 8 +++++--- doc/migrate-to-motor-3.rst | 8 +++++--- doc/requirements.rst | 8 +++++--- doc/tutorial-asyncio.rst | 8 +++++--- doc/tutorial-tornado.rst | 8 +++++--- 43 files changed, 215 insertions(+), 130 deletions(-) diff --git a/README.md b/README.md index bf8fe460..eb67f8d5 100644 --- a/README.md +++ b/README.md @@ -8,10 +8,11 @@ ![image](https://raw.github.com/mongodb/motor/master/doc/_static/motor.png) > [!WARNING] -> Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. -> Critical bug fixes will be made until May 14th, 2027. -> We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. -> To learn more, see the migration guide: https://www.mongodb.com/docs/languages/python/pymongo-driver/current/reference/migration/. +> 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/>. ## About diff --git a/doc/api-asyncio/aiohttp.rst b/doc/api-asyncio/aiohttp.rst index bc8fb71f..0e10ac2c 100644 --- a/doc/api-asyncio/aiohttp.rst +++ b/doc/api-asyncio/aiohttp.rst @@ -1,9 +1,11 @@ :mod:`motor.aiohttp` - Integrate Motor with the aiohttp web framework ===================================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.aiohttp diff --git a/doc/api-asyncio/asyncio_gridfs.rst b/doc/api-asyncio/asyncio_gridfs.rst index c8eeb7fc..c978d85b 100644 --- a/doc/api-asyncio/asyncio_gridfs.rst +++ b/doc/api-asyncio/asyncio_gridfs.rst @@ -1,9 +1,11 @@ asyncio GridFS Classes ====================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_asyncio diff --git a/doc/api-asyncio/asyncio_motor_change_stream.rst b/doc/api-asyncio/asyncio_motor_change_stream.rst index e62af375..62d220b9 100644 --- a/doc/api-asyncio/asyncio_motor_change_stream.rst +++ b/doc/api-asyncio/asyncio_motor_change_stream.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_asyncio.AsyncIOMotorChangeStream` ====================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_asyncio diff --git a/doc/api-asyncio/asyncio_motor_client.rst b/doc/api-asyncio/asyncio_motor_client.rst index 0ce81025..e938ee54 100644 --- a/doc/api-asyncio/asyncio_motor_client.rst +++ b/doc/api-asyncio/asyncio_motor_client.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_asyncio.AsyncIOMotorClient` -- Connection to MongoDB ========================================================================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. autoclass:: motor.motor_asyncio.AsyncIOMotorClient :members: diff --git a/doc/api-asyncio/asyncio_motor_client_encryption.rst b/doc/api-asyncio/asyncio_motor_client_encryption.rst index 3c186d77..3ec30750 100644 --- a/doc/api-asyncio/asyncio_motor_client_encryption.rst +++ b/doc/api-asyncio/asyncio_motor_client_encryption.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_asyncio.AsyncIOMotorClientEncryption` ========================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_asyncio diff --git a/doc/api-asyncio/asyncio_motor_client_session.rst b/doc/api-asyncio/asyncio_motor_client_session.rst index 61ea8069..77dd7f3c 100644 --- a/doc/api-asyncio/asyncio_motor_client_session.rst +++ b/doc/api-asyncio/asyncio_motor_client_session.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_asyncio.AsyncIOMotorClientSession` -- Sequence of operations ================================================================================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. autoclass:: motor.motor_asyncio.AsyncIOMotorClientSession :members: diff --git a/doc/api-asyncio/asyncio_motor_collection.rst b/doc/api-asyncio/asyncio_motor_collection.rst index d230043c..49dec304 100644 --- a/doc/api-asyncio/asyncio_motor_collection.rst +++ b/doc/api-asyncio/asyncio_motor_collection.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_asyncio.AsyncIOMotorCollection` ==================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_asyncio diff --git a/doc/api-asyncio/asyncio_motor_database.rst b/doc/api-asyncio/asyncio_motor_database.rst index e1c29899..48a3862d 100644 --- a/doc/api-asyncio/asyncio_motor_database.rst +++ b/doc/api-asyncio/asyncio_motor_database.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_asyncio.AsyncIOMotorDatabase` ================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_asyncio diff --git a/doc/api-asyncio/cursors.rst b/doc/api-asyncio/cursors.rst index 27cb4401..8d8df1c6 100644 --- a/doc/api-asyncio/cursors.rst +++ b/doc/api-asyncio/cursors.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_asyncio.AsyncIOMotorCursor` ================================================ -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_asyncio diff --git a/doc/api-asyncio/index.rst b/doc/api-asyncio/index.rst index 3d4690da..7b842f4e 100644 --- a/doc/api-asyncio/index.rst +++ b/doc/api-asyncio/index.rst @@ -1,9 +1,11 @@ Motor asyncio API ================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. toctree:: diff --git a/doc/api-tornado/cursors.rst b/doc/api-tornado/cursors.rst index ba693e4d..6bd25332 100644 --- a/doc/api-tornado/cursors.rst +++ b/doc/api-tornado/cursors.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_tornado.MotorCursor` ========================================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/gridfs.rst b/doc/api-tornado/gridfs.rst index d6d2b1b1..c2fd9cc6 100644 --- a/doc/api-tornado/gridfs.rst +++ b/doc/api-tornado/gridfs.rst @@ -1,9 +1,11 @@ Motor GridFS Classes ==================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/index.rst b/doc/api-tornado/index.rst index ad00f9aa..1ea4f7ab 100644 --- a/doc/api-tornado/index.rst +++ b/doc/api-tornado/index.rst @@ -1,9 +1,11 @@ Motor Tornado API ================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. toctree:: diff --git a/doc/api-tornado/motor_change_stream.rst b/doc/api-tornado/motor_change_stream.rst index 19a55188..aa42445c 100644 --- a/doc/api-tornado/motor_change_stream.rst +++ b/doc/api-tornado/motor_change_stream.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_tornado.MotorChangeStream` =============================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/motor_client.rst b/doc/api-tornado/motor_client.rst index e5864138..db6c1767 100644 --- a/doc/api-tornado/motor_client.rst +++ b/doc/api-tornado/motor_client.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_tornado.MotorClient` -- Connection to MongoDB ================================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/motor_client_encryption.rst b/doc/api-tornado/motor_client_encryption.rst index d2d09aa3..e6604310 100644 --- a/doc/api-tornado/motor_client_encryption.rst +++ b/doc/api-tornado/motor_client_encryption.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_tornado.MotorClientEncryption` =================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/motor_client_session.rst b/doc/api-tornado/motor_client_session.rst index d4740fe8..1d79573d 100644 --- a/doc/api-tornado/motor_client_session.rst +++ b/doc/api-tornado/motor_client_session.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_tornado.MotorClientSession` -- Sequence of operations ========================================================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/motor_collection.rst b/doc/api-tornado/motor_collection.rst index d463505e..4a6c09b9 100644 --- a/doc/api-tornado/motor_collection.rst +++ b/doc/api-tornado/motor_collection.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_tornado.MotorCollection` ============================================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/motor_database.rst b/doc/api-tornado/motor_database.rst index e88835c3..2e8bb323 100644 --- a/doc/api-tornado/motor_database.rst +++ b/doc/api-tornado/motor_database.rst @@ -1,9 +1,11 @@ :class:`~motor.motor_tornado.MotorDatabase` =========================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/api-tornado/web.rst b/doc/api-tornado/web.rst index 84e6f6b6..692107a6 100644 --- a/doc/api-tornado/web.rst +++ b/doc/api-tornado/web.rst @@ -1,9 +1,11 @@ :mod:`motor.web` - Integrate Motor with the Tornado web framework ================================================================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.web diff --git a/doc/changelog.rst b/doc/changelog.rst index 10347b7f..af11cc9d 100644 --- a/doc/changelog.rst +++ b/doc/changelog.rst @@ -8,9 +8,11 @@ Motor 3.7.1 The 3.7.1 release contains only documentation changes. -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. Motor 3.7.0 ----------- diff --git a/doc/configuration.rst b/doc/configuration.rst index 10a14ce0..b216739e 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -1,9 +1,11 @@ Configuration ============= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. TLS Protocol Version diff --git a/doc/developer-guide.rst b/doc/developer-guide.rst index e1556b0a..ad3a8722 100644 --- a/doc/developer-guide.rst +++ b/doc/developer-guide.rst @@ -2,9 +2,11 @@ Developer Guide =============== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. Some explanations for those who would like to contribute to Motor development. diff --git a/doc/differences.rst b/doc/differences.rst index a88ec1f2..131ea31e 100644 --- a/doc/differences.rst +++ b/doc/differences.rst @@ -4,9 +4,11 @@ Differences between Motor and PyMongo ===================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. important:: This page describes using Motor with Tornado. Beginning in version 0.5 Motor can also integrate with asyncio instead of Tornado. diff --git a/doc/examples/aiohttp_gridfs_example.rst b/doc/examples/aiohttp_gridfs_example.rst index 33d68470..75347492 100644 --- a/doc/examples/aiohttp_gridfs_example.rst +++ b/doc/examples/aiohttp_gridfs_example.rst @@ -1,9 +1,11 @@ AIOHTTPGridFS Example ===================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. Serve pre-compressed static content from GridFS over HTTP. Uses the `aiohttp`_ diff --git a/doc/examples/authentication.rst b/doc/examples/authentication.rst index 48b63a3c..4f6c3142 100644 --- a/doc/examples/authentication.rst +++ b/doc/examples/authentication.rst @@ -3,9 +3,11 @@ Authentication With Motor ========================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. This page describes using Motor with Tornado. Beginning in diff --git a/doc/examples/bulk.rst b/doc/examples/bulk.rst index b6037cdc..539a914d 100644 --- a/doc/examples/bulk.rst +++ b/doc/examples/bulk.rst @@ -5,9 +5,11 @@ Bulk Write Operations ===================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. testsetup:: diff --git a/doc/examples/encryption.rst b/doc/examples/encryption.rst index f5913fd4..25f0fd9e 100644 --- a/doc/examples/encryption.rst +++ b/doc/examples/encryption.rst @@ -3,9 +3,11 @@ Client-Side Field Level Encryption ================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. Starting in MongoDB 4.2, client-side field level encryption allows an application diff --git a/doc/examples/index.rst b/doc/examples/index.rst index edde082b..a0f80b83 100644 --- a/doc/examples/index.rst +++ b/doc/examples/index.rst @@ -1,9 +1,11 @@ Motor Examples ============== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. seealso:: :doc:`../tutorial-tornado` diff --git a/doc/examples/monitoring.rst b/doc/examples/monitoring.rst index 0cca041e..61825fd6 100644 --- a/doc/examples/monitoring.rst +++ b/doc/examples/monitoring.rst @@ -3,9 +3,11 @@ Application Performance Monitoring (APM) ======================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. Motor implements the same `Command Monitoring`_ and `Topology Monitoring`_ specifications as other MongoDB drivers. diff --git a/doc/examples/tailable-cursors.rst b/doc/examples/tailable-cursors.rst index dd5fc8f1..066e77a4 100644 --- a/doc/examples/tailable-cursors.rst +++ b/doc/examples/tailable-cursors.rst @@ -3,9 +3,11 @@ Motor Tailable Cursor Example ============================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. By default, MongoDB will automatically close a cursor when the client has diff --git a/doc/examples/timeouts.rst b/doc/examples/timeouts.rst index df64b299..b3b4fc12 100644 --- a/doc/examples/timeouts.rst +++ b/doc/examples/timeouts.rst @@ -4,9 +4,11 @@ Client Side Operation Timeout ============================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. PyMongo 4.2 introduced :meth:`~pymongo.timeout` and the ``timeoutMS`` diff --git a/doc/examples/tornado_change_stream_example.rst b/doc/examples/tornado_change_stream_example.rst index 11bf04c7..7d96d837 100644 --- a/doc/examples/tornado_change_stream_example.rst +++ b/doc/examples/tornado_change_stream_example.rst @@ -3,9 +3,11 @@ Tornado Change Stream Example ============================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/examples/type_hints.rst b/doc/examples/type_hints.rst index 62a6a853..4c486f2f 100644 --- a/doc/examples/type_hints.rst +++ b/doc/examples/type_hints.rst @@ -4,9 +4,11 @@ Type Hints ========== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. As of version 3.3.0, Motor ships with `type hints`_. With type hints, Python diff --git a/doc/features.rst b/doc/features.rst index ee200477..c00a17aa 100644 --- a/doc/features.rst +++ b/doc/features.rst @@ -4,9 +4,11 @@ Motor Features .. currentmodule:: motor.motor_tornado -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 diff --git a/doc/index.rst b/doc/index.rst index 3a9fc61a..bdc3f090 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -4,9 +4,11 @@ Motor: Asynchronous Python driver for MongoDB .. image:: _static/motor.png :align: center -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. About ----- diff --git a/doc/installation.rst b/doc/installation.rst index 1fb015c5..1193cac3 100644 --- a/doc/installation.rst +++ b/doc/installation.rst @@ -1,9 +1,11 @@ Installation ============ -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. Install Motor from PyPI_ with pip_:: diff --git a/doc/migrate-to-motor-2.rst b/doc/migrate-to-motor-2.rst index c7ca6f5d..99caf60b 100644 --- a/doc/migrate-to-motor-2.rst +++ b/doc/migrate-to-motor-2.rst @@ -1,9 +1,11 @@ Motor 2.0 Migration Guide ========================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/migrate-to-motor-3.rst b/doc/migrate-to-motor-3.rst index ade5f3fe..bd64fbb5 100644 --- a/doc/migrate-to-motor-3.rst +++ b/doc/migrate-to-motor-3.rst @@ -1,9 +1,11 @@ Motor 3.0 Migration Guide ========================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. currentmodule:: motor.motor_tornado diff --git a/doc/requirements.rst b/doc/requirements.rst index 8e2527d1..7d592c2b 100644 --- a/doc/requirements.rst +++ b/doc/requirements.rst @@ -1,9 +1,11 @@ Requirements ============ -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. The current version of Motor requires: diff --git a/doc/tutorial-asyncio.rst b/doc/tutorial-asyncio.rst index 663319c4..21121c00 100644 --- a/doc/tutorial-asyncio.rst +++ b/doc/tutorial-asyncio.rst @@ -3,9 +3,11 @@ Tutorial: Using Motor With :mod:`asyncio` ========================================= -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. These setups are redundant because I can't figure out how to make doctest diff --git a/doc/tutorial-tornado.rst b/doc/tutorial-tornado.rst index b6f8c104..23b471bc 100644 --- a/doc/tutorial-tornado.rst +++ b/doc/tutorial-tornado.rst @@ -3,9 +3,11 @@ Tutorial: Using Motor With Tornado ================================== -.. warning:: Motor will be deprecated on May 14th, 2026, one year after the production release of the PyMongo Async driver. Critical bug fixes will be made until May 14th, 2027. - We strongly recommend that Motor users migrate to the PyMongo Async driver while Motor is still supported. - To learn more, see `the migration guide `_. +.. 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 `_. .. These setups are redundant because I can't figure out how to make doctest