PYTHON-4576 Allow update to supply sort option #1881
Conversation
blink1073
requested review from
ShaneHarvey
and removed request for
caseyclements
pymongo/asynchronous/collection.py
Outdated
| multiple documents. The first document matched by the sort order will be updated. | ||
| :return: - An instance of :class:`~pymongo.results.UpdateResult`. | ||
| .. versionchanged:: 4.10 |
There was a problem hiding this comment.
4.10 -> 4.11 here and elsewhere.
| collation: Optional[Mapping[str, Any]] = None, | ||
| array_filters: Optional[list[Mapping[str, Any]]] = None, | ||
| hint: Union[str, dict[str, Any], None] = None, | ||
| sort: Optional[Mapping[str, Any]] = None, |
There was a problem hiding this comment.
This is slightly inconsistent with pymongo's other sort APIs which use _Sort type and allow a list of key pairs as well as a mapping. I think that's okay because mapping should be the preferred approach now (after PYTHON-2878).
I say we keep it like this and only add support for a list of pairs if a user requests it. It will save us the work of adding tests for the (list or pairs) behavior.
test/utils.py
Outdated
| arguments[arg_name] = list(sort_dict.items()) | ||
| if spec["name"] not in ["replaceOne", "updateOne"]: | ||
| sort_dict = arguments[arg_name] | ||
| arguments[arg_name] = list(sort_dict.items()) |
There was a problem hiding this comment.
I think we can remove this code altogether because we implemented https://jira.mongodb.org/browse/PYTHON-2878 in 4.6.
| aggregate expression context (e.g. "$$var"). | ||
| :param comment: A user-provided comment to attach to this | ||
| command. | ||
| :param sort: Specify which document the operation updates if the query matches |
There was a problem hiding this comment.
Could you add a mention for these new apis in the changelog?
…r into PYTHON-4576
doc/changelog.rst
Outdated
| - Added :func:`repr` support to :class:`pymongo.operations.IndexModel`. | ||
| - Added :func:`repr` support to :class:`pymongo.operations.SearchIndexModel`. | ||
| - Added ``sort`` parameter to | ||
| :meth:`~pymongo.collection.Collection.update_one` and :meth:`~pymongo.collection.Collection.replace_one` |
There was a problem hiding this comment.
Also the bulk UpdateOne/ReplaceOne operations.
2 participants
Notes for reviewer: