Atualizar versões do PyMongo

Visão geral

Esta página descreve as alterações que você deve fazer no seu aplicativo ao atualizar para uma nova versão do PyMongo.

Antes de atualizar, execute as seguintes ações:

• Certifique-se de que a nova versão do PyMongo seja compatível com as versões do MongoDB Server às quais seu aplicação se conecta e com a versão do Python em que seu aplicação é executado. Para obter informações sobre compatibilidade de versão, consulte a página Compatibilidade do PyMongo .

• Resolva quaisquer alterações significativas entre a versão do driver que seu aplicativo está usando e a versão de atualização planejada na seção Alterações significativas.

Mostrar avisos de depreciação

Quando você usa um recurso obsoleto do PyMongo, o driver levanta um DeprecationWarning. Por padrão, o interpretador Python silencia esses avisos. Para imprimi-las no stderr, inicie o Python com as opções -Wd .

O exemplo a seguir executa insert.py, um aplicativo Python que chama um método obsoleto. O interpretador mostra um DeprecationWarning porque o Python foi iniciado com as opções -Wd .

$ python3 -Wd insert.py
insert.py:4: DeprecationWarning: insert is deprecated. Use insert_one or insert_many instead.
  client.test.test.insert({})

Para tratar DeprecationWarning mensagens como exceções, inicie o Python com as opções -We , conforme mostrado no exemplo a seguir:

$ python3 -We insert.py
Traceback (most recent call last):
  File "insert.py", line 4, in <module>
    client.test.test.insert({})
  File "/home/durin/work/mongo-python-driver/pymongo/collection.py", line 2906, in insert
    "instead.", DeprecationWarning, stacklevel=2)
DeprecationWarning: insert is deprecated. Use insert_one or insert_many instead.

Mudanças de última hora

Uma alteração significativa é uma alteração de uma convenção ou comportamento a partir de uma versão específica do driver. Esse tipo de alteração pode impedir que seu aplicativo funcione corretamente se não for resolvido antes de atualizar o driver.

As alterações interruptivas nesta seção são categorizadas pela versão do driver que as introduziram. Ao atualizar as versões do driver, resolva todas as alterações interruptivas entre a versão atual e a atualizada.

# 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'}

>>> 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')])

>>> 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')])