Actualizar versiones de PyMongo

Cambios importantes en la versión 4.14

• Se elimina la compatibilidad con MongoDB Server v4.0. La versión mínima compatible con MongoDB Server ahora es v4.2.

• Al codificar un objeto bson.binary.BinaryVector, el valor del campo de metadatos padding debe cumplir las siguientes condiciones:

  • Si el subtipo binario es PACKED_BIT, el valor debe estar entre 0 y 7 (inclusive).

  • De lo contrario, el valor debe ser 0.

  Si no se cumplen las condiciones anteriores, PyMongo genera un ValueError.

• El parámetro options para el método uri_parser.parse_uri() es del tipo dict. Anteriormente, este parámetro era del tipo _CaseInsensitiveDictionary.

Cambios importantes en la versión 4.11

• Se elimina la compatibilidad con MongoDB Server v3.6. La versión mínima compatible con MongoDB Server ahora es v4.0.

• Se desestima la compatibilidad con MongoDB Server4.0 v. De acuerdo con los Programas del Ciclo de Vida del Software de MongoDB, una próxima versión secundaria de PyMongo aumentará la versión mínima de MongoDB Server 4.0 de 4.2 a.

• Se elimina la compatibilidad con Python v3.8. La versión mínima compatible ahora es la v3.9.

• Se elimina la compatibilidad con PyPy v3.9. La versión mínima compatible ahora es la v3.10.

• Se elimina la compatibilidad con el MONGODB-CR mecanismo de autenticación. Para obtener más información sobre la autenticación, consulte la guía "Mecanismos de autenticación".

Cambios importantes en la versión 4.9

• Debe utilizar pymongocrypt v1.10 o posterior para utilizar el cifrado de nivel de campo del lado del cliente (CSFLE) en su aplicación.

Cambios importantes en la versión 4.8

• Dado que PyMongo v4.8 usa hatch como sistema de compilación backend, ya no es posible compilar el controlador con el archivo setup.py. En su lugar, debe instalar PyMongo con pip. Para instalaciones editables, debe usar pip v21.3 o posterior.

Cambios importantes en la versión 4.7

• Todas las apariciones del tipo de colección SON en todas las clases y comandos internos se han cambiado a dict.

• La propiedad options.pool_options.metadata ahora es de tipo dict, no SON. El siguiente ejemplo de código muestra las diferencias en la forma en que estos formatos almacenan datos:

# Before (SON)
>>> from pymongo import MongoClient
>>> client = MongoClient()
>>> client.options.pool_options.metadata
SON([('driver', SON([('name', 'PyMongo'), ('version', '4.7.0.dev0')])), ('os', SON([('type', 'Darwin'), ('name', 'Darwin'), ('architecture', 'arm64'), ('version', '14.3')])), ('platform', 'CPython 3.11.6.final.0')])
# After (dict)
>>> client.options.pool_options.metadata
{'driver': {'name': 'PyMongo', 'version': '4.7.0.dev0'}, 'os': {'type': 'Darwin', 'name': 'Darwin', 'architecture': 'arm64', 'version': '14.3'}, 'platform': 'CPython 3.11.6.final.0'}

Para convertir un objeto de dict de una sola capa en un objeto de SON, pasa el objeto de dict al constructor de SON, tal como se muestra en el siguiente ejemplo:

>>> data_as_dict = client.options.pool_options.metadata
>>> SON(data_as_dict)
SON([('driver', {'name': 'PyMongo', 'version': '4.7.0.dev0'}), ('os', {'type': 'Darwin', 'name': 'Darwin', 'architecture': 'arm64', 'version': '14.3'}), ('platform', 'CPython 3.11.6.final.0')])

Si el objeto dict tiene varias capas, debe convertir los valores uno a la vez, como se muestra en el siguiente ejemplo:

>>> def dict_to_SON(data_as_dict: dict[Any, Any]):
...     data_as_SON = SON()
...     for key, value in data_as_dict.items():
...         data_as_SON[key] = dict_to_SON(value) if isinstance(value, dict) else value
...     return data_as_SON
>>>
>>> dict_to_SON(data_as_dict)
SON([('driver', SON([('name', 'PyMongo'), ('version', '4.7.0.dev0')])), ('os', SON([('type', 'Darwin'), ('name', 'Darwin'), ('architecture', 'arm64'), ('version', '14.3')])), ('platform', 'CPython 3.11.6.final.0')])

Cambios importantes en la versión 4.2

• Para mejorar el soporte para la herramienta Pyright, la ClientSession clase ya no utiliza tipificación genérica.

• Se requiere pymongocrypt v1.3.0 o posterior para el cifrado de nivel de campo del lado del cliente (CSFLE).

• Los paquetes bson, pymongo y gridfs ahora utilizan la variable __all__ para declarar sus APIs públicas. Si tu aplicación contiene una instrucción from bson import *, asegúrese de que siga importando las APIs necesarias.

• El método estimated_document_count() siempre usa el comando count. Este comando no está disponible en la API estable de MongoDB en las versiones 5.0.0 a 5.0.8. Si usa el método estimated_document_count() con la API estable, debe actualizar a MongoDB Server v5.0.9 o posterior, o configurar la opción pymongo.server_api.ServerApi.strict en False.