[Communication] Add moveParticipants functionality to Call Automation (#41448)

* Move Participants addition

* Updating the test case to move one participant

Author: v-vkaluri

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/__init__.py

@@ -18,6 +18,7 @@
     RecordingProperties,
     AddParticipantResult,
     RemoveParticipantResult,
+    MoveParticipantsResult,
     TransferCallResult,
     MediaStreamingOptions,
     TranscriptionOptions,
@@ -78,6 +79,7 @@
     "RecordingProperties",
     "AddParticipantResult",
     "RemoveParticipantResult",
+    "MoveParticipantsResult",
     "TransferCallResult",
     "MuteParticipantResult",
     "SendDtmfTonesResult",

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_call_connection_client.py

@@ -21,6 +21,7 @@
     CallConnectionProperties,
     AddParticipantResult,
     RemoveParticipantResult,
+    MoveParticipantsResult,
     TransferCallResult,
     MuteParticipantResult,
     SendDtmfTonesResult,
@@ -31,6 +32,7 @@
 from ._generated.models import (
     AddParticipantRequest,
     RemoveParticipantRequest,
+    MoveParticipantsRequest,
     TransferToParticipantRequest,
     PlayRequest,
     RecognizeRequest,
@@ -374,6 +376,46 @@ def remove_participant(
 
         return RemoveParticipantResult._from_generated(response)  # pylint:disable=protected-access
 
+    @distributed_trace
+    def move_participants(
+        self,
+        target_participants: List["CommunicationIdentifier"],
+        from_call: str,
+        *,
+        operation_context: Optional[str] = None,
+        operation_callback_url: Optional[str] = None,
+        **kwargs,
+    ) -> MoveParticipantsResult:
+        """Move participants from another call to this call.
+
+        :param target_participants: The participants to move to this call.
+        :type target_participants: list[~azure.communication.callautomation.CommunicationIdentifier]
+        :param from_call: The CallConnectionId for the call you want to move the participant from.
+        :type from_call: str
+        :keyword operation_context: Value that can be used to track this call and its associated events.
+        :paramtype operation_context: str
+        :keyword operation_callback_url: Set a callback URL that overrides the default callback URL set
+         by CreateCall/AnswerCall for this operation.
+         This setup is per-action. If this is not set, the default callback URL set by
+         CreateCall/AnswerCall will be used.
+        :paramtype operation_callback_url: str or None
+        :return: MoveParticipantsResult
+        :rtype: ~azure.communication.callautomation.MoveParticipantsResult
+        :raises ~azure.core.exceptions.HttpResponseError:
+        """
+        move_participants_request = MoveParticipantsRequest(
+            target_participants=[serialize_identifier(participant) for participant in target_participants],
+            from_call=from_call,
+            operation_context=operation_context,
+            operation_callback_uri=operation_callback_url,
+        )
+        process_repeatability_first_sent(kwargs)
+        response = self._call_connection_client.move_participants(
+            self._call_connection_id, move_participants_request, **kwargs
+        )
+
+        return MoveParticipantsResult._from_generated(response)  # pylint:disable=protected-access
+
     @overload
     def play_media(
         self,

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_content_downloader.py

@@ -20,7 +20,7 @@
 from azure.core.utils import case_insensitive_dict
 
 from ._generated import models as _models
-from ._generated._serialization import Serializer
+from ._generated._utils.serialization import Serializer
 from ._generated.operations import CallRecordingOperations
 
 _SERIALIZER = Serializer()

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_client.py

@@ -17,7 +17,7 @@
 
 from . import models as _models
 from ._configuration import AzureCommunicationCallAutomationServiceConfiguration
-from ._serialization import Deserializer, Serializer
+from ._utils.serialization import Deserializer, Serializer
 from .operations import (
     AzureCommunicationCallAutomationServiceOperationsMixin,
     CallConnectionOperations,
@@ -53,6 +53,7 @@ def __init__(self, endpoint: str, credential: AzureKeyCredential, **kwargs: Any)
         self._config = AzureCommunicationCallAutomationServiceConfiguration(
             endpoint=endpoint, credential=credential, **kwargs
         )
+
         _policies = kwargs.pop("policies", None)
         if _policies is None:
             _policies = [

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_utils/__init__.py

@@ -0,0 +1,6 @@
+# --------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# Code generated by Microsoft (R) AutoRest Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_serialization.py renamed to sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_utils/serialization.py

@@ -1,28 +1,10 @@
 # pylint: disable=line-too-long,useless-suppression,too-many-lines
+# coding=utf-8
 # --------------------------------------------------------------------------
-#
 # Copyright (c) Microsoft Corporation. All rights reserved.
-#
-# The MIT License (MIT)
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the ""Software""), to
-# deal in the Software without restriction, including without limitation the
-# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-# sell copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-# IN THE SOFTWARE.
-#
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# Code generated by Microsoft (R) AutoRest Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
 # pyright: reportUnnecessaryTypeIgnoreComment=false
@@ -411,7 +393,7 @@ def from_dict(
         :param function key_extractors: A key extractor function.
         :param str content_type: JSON by default, set application/xml if XML.
         :returns: An instance of this model
-        :raises: DeserializationError if something went wrong
+        :raises DeserializationError: if something went wrong
         :rtype: Self
         """
         deserializer = Deserializer(cls._infer_class_models())

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_vendor.py renamed to sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_utils/utils.py

@@ -6,20 +6,20 @@
 # --------------------------------------------------------------------------
 
 from abc import ABC
-from typing import TYPE_CHECKING
-
-from ._configuration import AzureCommunicationCallAutomationServiceConfiguration
+from typing import Generic, TYPE_CHECKING, TypeVar
 
 if TYPE_CHECKING:
-    from azure.core import PipelineClient
+    from .serialization import Deserializer, Serializer
+
 
-    from ._serialization import Deserializer, Serializer
+TClient = TypeVar("TClient")
+TConfig = TypeVar("TConfig")
 
 
-class AzureCommunicationCallAutomationServiceMixinABC(ABC):  # pylint: disable=name-too-long
+class ClientMixinABC(ABC, Generic[TClient, TConfig]):
     """DO NOT use this class. It is for internal typing use only."""
 
-    _client: "PipelineClient"
-    _config: AzureCommunicationCallAutomationServiceConfiguration
+    _client: TClient
+    _config: TConfig
     _serialize: "Serializer"
     _deserialize: "Deserializer"

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/aio/_client.py

@@ -16,7 +16,7 @@
 from azure.core.rest import AsyncHttpResponse, HttpRequest
 
 from .. import models as _models
-from .._serialization import Deserializer, Serializer
+from .._utils.serialization import Deserializer, Serializer
 from ._configuration import AzureCommunicationCallAutomationServiceConfiguration
 from .operations import (
     AzureCommunicationCallAutomationServiceOperationsMixin,
@@ -54,6 +54,7 @@ def __init__(self, endpoint: str, credential: AzureKeyCredential, **kwargs: Any)
         self._config = AzureCommunicationCallAutomationServiceConfiguration(
             endpoint=endpoint, credential=credential, **kwargs
         )
+
         _policies = kwargs.pop("policies", None)
         if _policies is None:
             _policies = [