Actualizar las 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 desaprueba el soporte para MongoDB Server v4.0. De acuerdo con los Cronogramas del ciclo de vida del software de MongoDB, una próxima versión menor de PyMongo aumentará la versión mínima de MongoDB Server de 4.0 a 4.2.

• Descarta el soporte para el Python v3.8. A versão mínima do Python suportada agora é v3.9.

• Se elimina el soporte para PyPy v3.9. La versión mínima de PyPy compatible es ahora 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 usar Cifrado en el lado del cliente a nivel de campo (CSFLE) en su aplicación.

Cambios importantes de la versión 4.8

• Debido a que PyMongo v4.8 utiliza hatch como su sistema de compilación backend, ya no puedes compilar el driver usando el archivo setup.py. En su lugar, debe instalar PyMongo usando pip. Para instalaciones editables, debe utilizar pip v21.3 o una versión posterior.

Cambios disruptivos en la versión 4.7

• Todas las incidencias del tipo de colección SON en todas las clases internas y comandos 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, debes 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 disruptivos 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 a 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 utiliza el comando count. Este comando no está disponible en la API estable en las versiones 5.0.0 de MongoDB até 5.0.8. Si usas el método estimated_document_count() con la Stable API, debes actualizar a MongoDB Server v5.0.9 o posterior, o configurar la opción pymongo.server_api.ServerApi.strict en False.