DOCSP-41080 - v4.8 (#97)

Co-authored-by: Rea Rustagi <[email protected]>

Author: mongoKart

config/redirects

@@ -1,6 +1,6 @@
 define: prefix docs/languages/python/drivers/pymongo
 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 master
+define: versions v4.0 v4.1 v4.2 v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 master
 
 symlink: current -> master
 

snooty.toml

@@ -29,8 +29,8 @@ 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.7"
-patch-version-number = "{+version-number+}.1"                                # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
+version-number = "4.8"
+patch-version-number = "{+version-number+}.0"                                # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
 version = "v{+version-number+}"
 stable-api = "Stable API"
 api-root = "https://pymongo.readthedocs.io/en/{+patch-version-number+}/api/"

source/includes/language-compatibility-table-pymongo.rst

@@ -18,6 +18,18 @@ Python 3
      - CPython 3.4
      - PyPy3
 
+   * - 4.8
+     - ✓ 
+     - ✓ 
+     - ✓ 
+     - ✓ 
+     - ✓ 
+     -
+     -
+     -
+     -
+     -
+
    * - 4.5 to 4.7
      - ✓
      - ✓

source/includes/mongodb-compatibility-table-pymongo.rst

@@ -12,7 +12,7 @@
      - MongoDB 4.0
      - MongoDB 3.6
 
-   * - 4.4 to 4.7
+   * - 4.4 to 4.8
      - ✓
      - ✓
      - ✓

source/upgrade.txt

@@ -104,6 +104,16 @@ and upgrade versions.
 
 .. diagram for this example?
 
+.. _version-4.8-breaking-changes:
+
+Version 4.8 Breaking Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Because {+driver-short+} v4.8 uses ``hatch`` as its backend build system,
+  you can no longer build the driver by using the ``setup.py`` file.
+  Instead, you must install {+driver-short+} by using pip. For editable installations,
+  you must use pip v21.3 or later.
+
 .. _version-4.7-breaking-changes:
 
 Version 4.7 Breaking Changes

source/whats-new.txt

@@ -19,10 +19,36 @@ What's New
 
 Learn what's new in:
 
+* :ref:`Version 4.8 <version-4.8>`
 * :ref:`Version 4.7 <version-4.7>`
 
 .. _upcoming-breaking-changes:
 
+.. _version-4.8:
+
+What's New in 4.8
+-----------------
+
+.. warning:: Breaking Changes
+
+   {+driver-short+} v4.8 contains breaking changes. For more information, see
+   :ref:`version-4.8-breaking-changes`.
+   
+The {+driver-short+} v4.8 release includes the following new features:
+
+- Implemented Secure Software Development Life Cycle (SSDLC) automation in the release
+  process. GitHub releases include a software bill of materials (SBOM) and signature
+  files corresponding to the distribution files released on PyPI.
+- In objects of type ``bson.binary.Binary``, the ``repr()`` method is redacted when the binary
+  subtype is ``SENSITIVE_SUBTYPE`` (``8``).
+- Fixed a bug in change streams where both the ``startAtOperationTime`` and ``resumeToken``
+  fields could be added to a retry attempt, which caused the retry to fail.
+- On Windows, changed handshake metadata for ``os.name`` to ``Windows`` to improve import time.
+- Improved performance of ``MongoClient`` operations, especially when the driver is
+  running many operations concurrently.
+- Added a fallback to the stdlib ``ssl`` module if importing the ``pyopenssl`` module
+  fails with an ``AttributeError``.
+
 .. _version-4.7:
 
 What's New in 4.7