From fa80973fad813023f1303cf258e352f3d60b391a Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Mon, 16 Jun 2025 11:41:32 -0400 Subject: [PATCH 1/9] DOCSP-50785: Update Motor deprecation verbiage --- snooty.toml | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/snooty.toml b/snooty.toml index 190f956b..a0682deb 100644 --- a/snooty.toml +++ b/snooty.toml @@ -25,10 +25,11 @@ atlas = "MongoDB Atlas" targets = ["motor.txt"] variant = "warning" value = """ - As of May 14th, 2025, Motor has been sunset in favor of the GA release of the PyMongo Async API in Pymongo. \ - No new features will be added to Motor. Motor will be deprecated on May 14th, 2026, \ - and no further bug fixes will be released after deprecation, with the exception of critical bug fixes, which will be released until May 14th, 2027. \ - We strongly recommend that Motor users migrate to PyMongo Async while Motor is still supported. \ - To learn how to migrate from Motor to the PyMongo Async API, see the \ - `Migrate to PyMongo Async guide `__. + As of May 14, 2025, Motor is deprecated in favor of the GA release of the PyMongo Async + API in the PyMongo library. No new features will be added to Motor, and we will only + provide bug fixes until it reaches end of life on May 14, 2026. After that, we will only + fix critigal bugs until final support ends on May 14, 2027. We + strongly recommend migrating to the PyMongo Async API while Motor is still supported. + For help transitioning, see the `Migrate to PyMongo Async Date: Mon, 16 Jun 2025 11:51:41 -0400 Subject: [PATCH 2/9] Fix? --- snooty.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snooty.toml b/snooty.toml index a0682deb..f2b2872d 100644 --- a/snooty.toml +++ b/snooty.toml @@ -30,6 +30,6 @@ value = """ provide bug fixes until it reaches end of life on May 14, 2026. After that, we will only fix critigal bugs until final support ends on May 14, 2027. We strongly recommend migrating to the PyMongo Async API while Motor is still supported. - For help transitioning, see the `Migrate to PyMongo Async Date: Mon, 16 Jun 2025 12:10:36 -0400 Subject: [PATCH 3/9] Fix? --- snooty.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snooty.toml b/snooty.toml index f2b2872d..ae3d338d 100644 --- a/snooty.toml +++ b/snooty.toml @@ -30,6 +30,6 @@ value = """ provide bug fixes until it reaches end of life on May 14, 2026. After that, we will only fix critigal bugs until final support ends on May 14, 2027. We strongly recommend migrating to the PyMongo Async API while Motor is still supported. - For more information on migrating, see the :ref:`pymongo-async-migration` + For more information on migrating, see the `Migrate to PyMongo Async Date: Mon, 16 Jun 2025 12:13:39 -0400 Subject: [PATCH 4/9] Fix --- snooty.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snooty.toml b/snooty.toml index ae3d338d..5e05e0ed 100644 --- a/snooty.toml +++ b/snooty.toml @@ -30,6 +30,6 @@ value = """ provide bug fixes until it reaches end of life on May 14, 2026. After that, we will only fix critigal bugs until final support ends on May 14, 2027. We strongly recommend migrating to the PyMongo Async API while Motor is still supported. - For more information on migrating, see the `Migrate to PyMongo Async `__ guide in the PyMongo documentation. """ From 5a46b00e72b8a7ae14c1cecaa13038e9991f8b96 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Mon, 16 Jun 2025 12:18:28 -0400 Subject: [PATCH 5/9] Fix --- snooty.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snooty.toml b/snooty.toml index 5e05e0ed..1315a1a6 100644 --- a/snooty.toml +++ b/snooty.toml @@ -28,7 +28,7 @@ value = """ As of May 14, 2025, Motor is deprecated in favor of the GA release of the PyMongo Async API in the PyMongo library. No new features will be added to Motor, and we will only provide bug fixes until it reaches end of life on May 14, 2026. After that, we will only - fix critigal bugs until final support ends on May 14, 2027. We + fix critical bugs until final support ends on May 14, 2027. We strongly recommend migrating to the PyMongo Async API while Motor is still supported. For more information on migrating, see the `Migrate to PyMongo Async `__ guide in the PyMongo documentation. From 103ce283643f340ed42b9e7ec371bccf1cec108b Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Mon, 16 Jun 2025 12:56:58 -0400 Subject: [PATCH 6/9] MW feedback --- snooty.toml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/snooty.toml b/snooty.toml index 1315a1a6..f49cff1c 100644 --- a/snooty.toml +++ b/snooty.toml @@ -26,10 +26,10 @@ targets = ["motor.txt"] variant = "warning" value = """ As of May 14, 2025, Motor is deprecated in favor of the GA release of the PyMongo Async - API in the PyMongo library. No new features will be added to Motor, and we will only - provide bug fixes until it reaches end of life on May 14, 2026. After that, we will only - fix critical bugs until final support ends on May 14, 2027. We - strongly recommend migrating to the PyMongo Async API while Motor is still supported. - For more information on migrating, see the `Migrate to PyMongo Async `__ + API in the PyMongo library. We will not add new features to Motor, and we will + provide only bug fixes until it reaches end of life on May 14, 2026. After that, we will + fix only critical bugs until final support ends on May 14, 2027. We + strongly recommend migrating to the PyMongo Async API while Motor is still supported.\ + For more information about migrating, see the `Migrate to PyMongo Async `__ guide in the PyMongo documentation. """ From 12f8cb6c18745fa3d96fb9d078e0adee1dc98451 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Mon, 16 Jun 2025 13:04:05 -0400 Subject: [PATCH 7/9] Fix? --- snooty.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snooty.toml b/snooty.toml index f49cff1c..007795fc 100644 --- a/snooty.toml +++ b/snooty.toml @@ -29,7 +29,7 @@ value = """ API in the PyMongo library. We will not add new features to Motor, and we will provide only bug fixes until it reaches end of life on May 14, 2026. After that, we will fix only critical bugs until final support ends on May 14, 2027. We - strongly recommend migrating to the PyMongo Async API while Motor is still supported.\ + strongly recommend migrating to the PyMongo Async API while Motor is still supported.\n For more information about migrating, see the `Migrate to PyMongo Async `__ guide in the PyMongo documentation. """ From 34792718670d006b4c8a67d5c48bd267c4a551f5 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Mon, 16 Jun 2025 13:06:57 -0400 Subject: [PATCH 8/9] How about this --- snooty.toml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/snooty.toml b/snooty.toml index 007795fc..b9201749 100644 --- a/snooty.toml +++ b/snooty.toml @@ -29,7 +29,8 @@ value = """ API in the PyMongo library. We will not add new features to Motor, and we will provide only bug fixes until it reaches end of life on May 14, 2026. After that, we will fix only critical bugs until final support ends on May 14, 2027. We - strongly recommend migrating to the PyMongo Async API while Motor is still supported.\n + strongly recommend migrating to the PyMongo Async API while Motor is still supported. + For more information about migrating, see the `Migrate to PyMongo Async `__ guide in the PyMongo documentation. """ From 61b7a0408db267fd3f5c9320180aa037ba298b9f Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Mon, 16 Jun 2025 14:28:25 -0400 Subject: [PATCH 9/9] Fix --- snooty.toml | 14 -------------- source/motor.txt | 13 +++++++++++++ 2 files changed, 13 insertions(+), 14 deletions(-) diff --git a/snooty.toml b/snooty.toml index b9201749..4d0cd304 100644 --- a/snooty.toml +++ b/snooty.toml @@ -20,17 +20,3 @@ stable-api = "Stable API" node-driver-long = "MongoDB Node.js Driver" node-driver-short = "Node.js Driver" atlas = "MongoDB Atlas" - -[[banners]] -targets = ["motor.txt"] -variant = "warning" -value = """ - As of May 14, 2025, Motor is deprecated in favor of the GA release of the PyMongo Async - API in the PyMongo library. We will not add new features to Motor, and we will - provide only bug fixes until it reaches end of life on May 14, 2026. After that, we will - fix only critical bugs until final support ends on May 14, 2027. We - strongly recommend migrating to the PyMongo Async API while Motor is still supported. - - For more information about migrating, see the `Migrate to PyMongo Async `__ - guide in the PyMongo documentation. - """ diff --git a/source/motor.txt b/source/motor.txt index 0777c457..e8fe7d4f 100644 --- a/source/motor.txt +++ b/source/motor.txt @@ -22,6 +22,19 @@ Motor (Async Driver) :depth: 1 :class: twocols +.. banner:: + :variant: warning + + As of May 14, 2025, Motor is deprecated in favor of the GA release of the PyMongo Async + API in the PyMongo library. We will not add new features to Motor, and we will + provide only bug fixes until it reaches end of life on May 14, 2026. After that, we will + fix only critical bugs until final support ends on May 14, 2027. We + strongly recommend migrating to the PyMongo Async API while Motor is still supported. + + For more information about migrating, see the `Migrate to PyMongo Async `__ + guide in the PyMongo documentation. + + Introduction ------------