Method add

couchbase/datastructures.py:699–728

Adds a new item to the set. Returning whether the item already existed in the set or not. Args: value (Any): Returns: bool: True if the value was added, False otherwise (meaning the value already exists in the set).

(self, value: Any)

                                    transcoder=transcoder)

    def add(self, value: Any) -> bool:
        """Adds a new item to the set. Returning whether the item already existed in the set or not.

        Args:
            value (Any):

        Returns:
            bool:  True if the value was added, False otherwise (meaning the value already
                exists in the set).

        """
        op_type = DatastructureOperationType.SetAdd
        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:
                try:
                    op = array_addunique('', value)
                    req = self._impl.request_builder.build_mutate_in_request(self._key,
                                                                             (op,),
                                                                             obs_handler,
                                                                             parent_span=ds_obs_handler.wrapped_span)
                    self._execute_op(self._impl.mutate_in,
                                     req,
                                     obs_handler,
                                     ds_obs_handler.wrapped_span,
                                     create_type=True)
                    return True
                except PathExistsException:
                    return False

    def remove(self, value: Any, timeout: Optional[timedelta] = None) -> None:  # noqa: C901
        """Removes a specific value from the set.