DOCSP-49183: v4.12 (#251)

Author: mcmorisi

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
 

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"

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
      - ✓ 
      -
      -

source/reference/release-notes.txt

@@ -20,6 +20,7 @@ Release Notes
 
 Learn what's new in:
 
+* :ref:`Version 4.12 <version-4.12>`
 * :ref:`Version 4.11 <version-4.11>`
 * :ref:`Version 4.10 <version-4.10>`
 * :ref:`Version 4.9 <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 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``,
+  ``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