From 7ea9f724405e411801731986675c13470c8e4d80 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Tue, 8 Apr 2025 14:49:08 -0400 Subject: [PATCH 1/3] DOCSP-49183: v4.12 --- config/redirects | 2 +- snooty.toml | 2 +- source/reference/release-notes.txt | 28 ++++++++++++++++++++++++++++ 3 files changed, 30 insertions(+), 2 deletions(-) diff --git a/config/redirects b/config/redirects index 5c025fe5..5011fd6f 100644 --- a/config/redirects +++ b/config/redirects @@ -1,6 +1,6 @@ define: prefix docs/languages/python/pymongo-driver define: base https://www.mongodb.com/${prefix} -define: versions v4.0 v4.1 v4.2 v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 4.10 4.11 master +define: versions v4.0 v4.1 v4.2 v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 4.10 4.11 4.12 master symlink: current -> master diff --git a/snooty.toml b/snooty.toml index ba2f5a82..a4215a21 100644 --- a/snooty.toml +++ b/snooty.toml @@ -30,7 +30,7 @@ mdb-server = "MongoDB Server" mongo-community = "MongoDB Community Edition" mongo-enterprise = "MongoDB Enterprise Edition" docs-branch = "master" # always set this to the docs branch (i.e. master, 1.7, 1.8, etc.) -version-number = "4.11" +version-number = "4.12" patch-version-number = "{+version-number+}" # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.) version = "v{+version-number+}" stable-api = "Stable API" diff --git a/source/reference/release-notes.txt b/source/reference/release-notes.txt index 7756d3ff..76b712ca 100644 --- a/source/reference/release-notes.txt +++ b/source/reference/release-notes.txt @@ -20,6 +20,7 @@ Release Notes Learn what's new in: +* :ref:`Version 4.12 ` * :ref:`Version 4.11 ` * :ref:`Version 4.10 ` * :ref:`Version 4.9 ` @@ -37,6 +38,33 @@ version of {+driver-short+} will raise the minimum {+mdb-server+} version from 4.0 to 4.2. {+driver-short+} will no longer support {+mdb-server+} 4.0. To learn how to upgrade your driver version, see the :ref:`pymongo-upgrade` guide. +.. _version-4.12: + +What's New in 4.12 +------------------ + +The {+driver-short+} v4.12 release includes the following new features: + +- Adds support for configuring DEK cache lifetime by using the ``key_expiration_ms`` + argument to ``AutoEncryptionOpts``. +- Adds support for ``$lookup`` in CSFLE and QE for {+mdb-server+} 8.1 and later. +- Adds the ``gridfs.asynchronous.grid_file.AsyncGridFSBucket.rename_by_name()`` and + ``gridfs.grid_file.GridFSBucket.rename_by_name()`` methods. You can use these methods for + more performant renaming of files with multiple revisions. +- Adds the ``gridfs.asynchronous.grid_file.AsyncGridFSBucket.delete_by_name()`` and + ``gridfs.grid_file.GridFSBucket.delete_by_name()`` methods. You can use these methods for + more performant deletion of files with multiple revisions. +- ``AsyncMongoClient`` objects no longer perform DNS resolution for ``mongodb+srv://`` + connection strings on creation. To avoid blocking the ``asyncio`` loop, {+driver-short+} + now defers teh resolution until the client is first connected. +- Adds index hinting support to the ``pymongo.asynchronous.collection.AsyncCollection.distinct()`` + and ``pymongo.collection.Collection.distinct()`` methods. +- Deprecates the ``hedge`` parameter for the ``PrimaryPreferred``, ``Secondary``, + ``SecondaryPreferred``, and ``Nearest`` read preferences. Support for ``hedge`` will be + removed in {+driver-short+} v5.0. +- Removes PyOpenSSL support from the {+driver-async+} driver. +- Allows valid SRV hostnames with fewer than 3 parts. + .. _version-4.11: What's New in 4.11 From 77de789559539e963b2e806f2fab742b14ddaafc Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Tue, 8 Apr 2025 15:32:17 -0400 Subject: [PATCH 2/3] Fix --- source/includes/language-compatibility-table-pymongo.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/includes/language-compatibility-table-pymongo.rst b/source/includes/language-compatibility-table-pymongo.rst index 40ff5b4d..381db20d 100644 --- a/source/includes/language-compatibility-table-pymongo.rst +++ b/source/includes/language-compatibility-table-pymongo.rst @@ -27,7 +27,7 @@ CPython - CPython 3.5 - CPython 3.4 - * - 4.11 + * - 4.11 to 4.12 - ✓ - ✓ - ✓ @@ -199,7 +199,7 @@ PyPy - PyPy3.6 - PyPy3.5 - * - 4.11 + * - 4.11 to 4.12 - ✓ - - From 66719b3cd488ce166c40d814e50eb2dd9f391ae7 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Tue, 8 Apr 2025 16:20:42 -0400 Subject: [PATCH 3/3] Fix --- source/reference/release-notes.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/reference/release-notes.txt b/source/reference/release-notes.txt index 76b712ca..60884e98 100644 --- a/source/reference/release-notes.txt +++ b/source/reference/release-notes.txt @@ -56,7 +56,7 @@ The {+driver-short+} v4.12 release includes the following new features: more performant deletion of files with multiple revisions. - ``AsyncMongoClient`` objects no longer perform DNS resolution for ``mongodb+srv://`` connection strings on creation. To avoid blocking the ``asyncio`` loop, {+driver-short+} - now defers teh resolution until the client is first connected. + now defers the resolution until the client is first connected. - Adds index hinting support to the ``pymongo.asynchronous.collection.AsyncCollection.distinct()`` and ``pymongo.collection.Collection.distinct()`` methods. - Deprecates the ``hedge`` parameter for the ``PrimaryPreferred``, ``Secondary``,