What's New

Adds provisional support for a new binary BSON subtype (9), which can be used for efficient storage and retrieval of vectors by using the bson.binary.Binary.from_vector() and bson.binary.Binary.as_vector() methods. Support for BSON subtype 9 is in beta and is subject to change before the generally available release.

Adds "c" to the driver.name client metadata field when an application uses the C extension.

Fixes a bug that could cause AsyncMongoClient to deadlock.

Adds support for MongoDB Server 8.0 and Python 3.13.

Adds support for Queryable Encryption range queries. To use this feature, your app must connect to MongoDB Server 8.0 or later. For more information about Queryable Encryption, see Queryable Encryption in the MongoDB Server manual.

Adds a new experimental asynchronous API as a replacement for Motor. This API is in beta and is subject to change before the generally available release.

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.

Added the Hello.connection_id, CommandStartedEvent.server_connection_id, CommandSucceededEvent.server_connection_id, and CommandFailedEvent.server_connection_id properties.

Added support for name suffixes for Key Management Service (KMS) providers for Client-Side Field Level Encryption (CSFLE). This feature requires pymongocrypt v1.9+ and libmongocrypt v1.9+. For more information, see the API documentation for the AutoEncryptionOpts class.

Improved the performance of encoding BSON documents to JSON.

The ClientEncryption.encrypt() and ClientEncryption.encrypt_expression() methods now allow the key_id argument to be passed in as a UUID Object.

Inflating a RawBSONDocument object containing a Code value no longer causes an error.

Fixed a bug in Python 3.12 where the error message RuntimeError: can't create new thread at interpreter shutdown could be written to stderr when a MongoClient thread starts as the Python interpreter is shutting down.

Fixed a bug where Int64 instances could not always be encoded by orjson. Code like the following example now runs correctly: