Actualizar las versiones de PyMongo

Versión 4.14 cambio disruptivo

• Descarta el soporte para el MongoDB Server v4.0. La versión mínima compatible de MongoDB Server es ahora la v4.2.

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

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

  • Si no, 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.

Versión 4.11 cambio disruptivo

• Descarta el soporte para el MongoDB Server v3.6. La versión mínima compatible de MongoDB Server es ahora la 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.

• Deja de soportar el mecanismo de autenticación MONGODB-CR. Para obtener más información sobre autenticación, consulta la guía de Mecanismos de Autenticación.

Versión 4.9 cambio disruptivo

• 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 disruptivos en 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 de la herramienta Pyright , la clase ClientSession ya no utiliza tipado genérico.

• 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.