Method list_set

couchbase/collection.py:1274–1317

Sets an item within a list at a given position. .. warning:: This method is deprecated and will be removed in the 4.7.0 version. Use :meth:`.CouchbaseList.set_at` instead. Args: key (str): The key for the list document. index (int):

(self,
                 key: str,
                 index: int,
                 value: JSONType,
                 **kwargs: object
                 )

                return OperationResult(sd_res.cas, sd_res.mutation_token())

    def list_set(self,
                 key: str,
                 index: int,
                 value: JSONType,
                 **kwargs: object
                 ) -> OperationResult:
        """Sets an item within a list at a given position.

        .. warning::
            This method is deprecated and will be removed in the 4.7.0 version.  Use :meth:`.CouchbaseList.set_at`
            instead.

        Args:
            key (str): The key for the list document.
            index (int): The position to replace.
            value (JSONType): The value to prepend to the list.
            **kwargs (Dict[str, Any]): keyword arguments that can be used as optional parameters
                for this operation.

        Returns:
            :class:`~couchbase.result.OperationResult`: An instance of :class:`~couchbase.result.OperationResult`.

        Raises:
            :class:`~couchbase.exceptions.DocumentNotFoundException`: If the key provided does not exist
                on the server.
            IndexError: If the index is out of bounds.

        """
        op_type = DatastructureOperationType.ListSetAt
        with ObservableRequestHandler(op_type, self._impl.observability_instruments) as ds_obs_handler:
            ds_obs_handler.create_kv_span(self._impl._request_builder._collection_dtls.get_details_as_dict())
            kv_op_type = KeyValueOperationType.MutateIn
            with ObservableRequestHandler(kv_op_type, self._impl.observability_instruments) as obs_handler:
                op = replace(f'[{index}]', value)
                req = self._impl.request_builder.build_mutate_in_request(key,
                                                                         (op,),
                                                                         obs_handler,
                                                                         **kwargs)
                sd_res = self._execute_deprecated_ds_func(self._impl.mutate_in,
                                                          req,
                                                          obs_handler,
                                                          ds_obs_handler.wrapped_span,
                                                          path_value=index)
                return OperationResult(sd_res.cas, sd_res.mutation_token())

    def list_get(self, key: str, index: int, **kwargs: object) -> Any:
        """Get a specific element within a list.