Appium-Python-Client 3.2.1__tar.gz → 4.0.1__tar.gz

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/Appium_Python_Client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Appium-Python-Client
-Version: 3.2.1
+Version: 4.0.1
 Summary: Python client for Appium
 Home-page: http://appium.io/
 Author: Isaac Murchie
@@ -25,6 +25,7 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: selenium~=4.12
 
 # Appium Python Client
 
@@ -75,7 +76,7 @@ download and unarchive the source tarball (Appium-Python-Client-X.X.tar.gz).
 |`2.10.0` - `2.11.1` |`4.1.0` - `4.11.2` | 3.7+ |
 |`2.2.0` - `2.9.0` |`4.1.0` - `4.9.0` | 3.7+ |
 |`2.0.0` - `2.1.4` |`4.0.0` | 3.7+ |
-|`1.0.0` - `1.1.0` |`3.x`| 3.7, 3.8 |
+|`1.0.0` - `1.3.0` |`3.x`| 3.7+ |
 |`0.52` and below|`3.x`| 2.7, 3.4 - 3.7 |
 
 The Appium Python Client depends on [Selenium Python binding](https://pypi.org/project/selenium/), thus
@@ -87,10 +88,20 @@ For example, some changes in the Selenium binding could break the Appium client.
 > to keep compatible version combinations.
 
 
+### Quick migration guide from v3 to v4
+- Removal
+    - `MultiAction` and `TouchAction` are removed. Please use W3C WebDriver actions or `mobile:` extensions
+        - [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+        - https://www.selenium.dev/documentation/webdriver/actions_api/
+        - https://www.youtube.com/watch?v=oAJ7jwMNFVU
+        - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
+        - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
+    - Deprecated `AppiumBy.WINDOWS_UI_AUTOMATION`, which has no usage right now.
+
 ### Quick migration guide from v2 to v3
 - `options` keyword argument in the `webdriver.Remote` constructor such as `XCUITestOptions` instead of `desired_capabilities`
     - Available options are https://github.com/appium/python-client/tree/master/appium/options
-        - Please check the [Usage](#usage) below as an exampple.
+        - Please check the [Usage](#usage) below as an example.
     - Not a "new" change, but the `desired_capabilities` argument has been removed since v3.
 - Replacement
     - `start_activity` method: Please use [`mobile: startActivity`](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-startactivity)
@@ -111,12 +122,6 @@ For example, some changes in the Selenium binding could break the Appium client.
     - Added `strict_ssl` to relax SSL errors such as self-signed ones
 - Deprecated
     - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions or `mobile:` extensions
-        - e.g.
-            - [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
-            - https://www.selenium.dev/documentation/webdriver/actions_api/
-            - https://www.youtube.com/watch?v=oAJ7jwMNFVU
-            - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
-            - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
     - `launch_app`, `close_app`, and `reset` are deprecated. Please read [issues#15807](https://github.com/appium/appium/issues/15807) for more details
 
 #### MultiAction/TouchAction to W3C actions

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/Appium_Python_Client.egg-info/SOURCES.txt

@@ -286,8 +286,6 @@ appium/webdriver/webdriver.py
 appium/webdriver/webelement.py
 appium/webdriver/common/__init__.py
 appium/webdriver/common/appiumby.py
-appium/webdriver/common/multi_action.py
-appium/webdriver/common/touch_action.py
 appium/webdriver/extensions/__init__.py
 appium/webdriver/extensions/action_helpers.py
 appium/webdriver/extensions/applications.py
@@ -316,7 +314,6 @@ appium/webdriver/extensions/android/performance.py
 appium/webdriver/extensions/android/power.py
 appium/webdriver/extensions/android/sms.py
 appium/webdriver/extensions/android/system_bars.py
-docs/.DS_Store
 docs/Makefile
 docs/README.md
 docs/conf.py
@@ -328,72 +325,4 @@ docs/webdriver.common.rst
 docs/webdriver.extensions.android.rst
 docs/webdriver.extensions.rst
 docs/webdriver.extensions.search_context.rst
-docs/webdriver.rst
-docs/_build/doctrees/appium.common.doctree
-docs/_build/doctrees/appium.doctree
-docs/_build/doctrees/appium.webdriver.common.doctree
-docs/_build/doctrees/appium.webdriver.doctree
-docs/_build/doctrees/appium.webdriver.extensions.android.doctree
-docs/_build/doctrees/appium.webdriver.extensions.doctree
-docs/_build/doctrees/appium.webdriver.extensions.search_context.doctree
-docs/_build/doctrees/environment.pickle
-docs/_build/doctrees/index.doctree
-docs/_build/html/.buildinfo
-docs/_build/html/.nojekyll
-docs/_build/html/appium.common.html
-docs/_build/html/appium.html
-docs/_build/html/appium.webdriver.common.html
-docs/_build/html/appium.webdriver.extensions.android.html
-docs/_build/html/appium.webdriver.extensions.html
-docs/_build/html/appium.webdriver.extensions.search_context.html
-docs/_build/html/appium.webdriver.html
-docs/_build/html/genindex.html
-docs/_build/html/index.html
-docs/_build/html/objects.inv
-docs/_build/html/py-modindex.html
-docs/_build/html/search.html
-docs/_build/html/searchindex.js
-docs/_build/html/_sources/appium.common.rst.txt
-docs/_build/html/_sources/appium.rst.txt
-docs/_build/html/_sources/appium.webdriver.common.rst.txt
-docs/_build/html/_sources/appium.webdriver.extensions.android.rst.txt
-docs/_build/html/_sources/appium.webdriver.extensions.rst.txt
-docs/_build/html/_sources/appium.webdriver.extensions.search_context.rst.txt
-docs/_build/html/_sources/appium.webdriver.rst.txt
-docs/_build/html/_sources/index.rst.txt
-docs/_build/html/_static/basic.css
-docs/_build/html/_static/doctools.js
-docs/_build/html/_static/documentation_options.js
-docs/_build/html/_static/file.png
-docs/_build/html/_static/jquery-3.5.1.js
-docs/_build/html/_static/jquery.js
-docs/_build/html/_static/language_data.js
-docs/_build/html/_static/minus.png
-docs/_build/html/_static/plus.png
-docs/_build/html/_static/pygments.css
-docs/_build/html/_static/searchtools.js
-docs/_build/html/_static/underscore-1.13.1.js
-docs/_build/html/_static/underscore.js
-docs/_build/html/_static/css/badge_only.css
-docs/_build/html/_static/css/theme.css
-docs/_build/html/_static/css/fonts/Roboto-Slab-Bold.woff
-docs/_build/html/_static/css/fonts/Roboto-Slab-Bold.woff2
-docs/_build/html/_static/css/fonts/Roboto-Slab-Regular.woff
-docs/_build/html/_static/css/fonts/Roboto-Slab-Regular.woff2
-docs/_build/html/_static/css/fonts/fontawesome-webfont.eot
-docs/_build/html/_static/css/fonts/fontawesome-webfont.svg
-docs/_build/html/_static/css/fonts/fontawesome-webfont.ttf
-docs/_build/html/_static/css/fonts/fontawesome-webfont.woff
-docs/_build/html/_static/css/fonts/fontawesome-webfont.woff2
-docs/_build/html/_static/css/fonts/lato-bold-italic.woff
-docs/_build/html/_static/css/fonts/lato-bold-italic.woff2
-docs/_build/html/_static/css/fonts/lato-bold.woff
-docs/_build/html/_static/css/fonts/lato-bold.woff2
-docs/_build/html/_static/css/fonts/lato-normal-italic.woff
-docs/_build/html/_static/css/fonts/lato-normal-italic.woff2
-docs/_build/html/_static/css/fonts/lato-normal.woff
-docs/_build/html/_static/css/fonts/lato-normal.woff2
-docs/_build/html/_static/js/badge_only.js
-docs/_build/html/_static/js/html5shiv-printshiv.min.js
-docs/_build/html/_static/js/html5shiv.min.js
-docs/_build/html/_static/js/theme.js
+docs/webdriver.rst

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Appium-Python-Client
-Version: 3.2.1
+Version: 4.0.1
 Summary: Python client for Appium
 Home-page: http://appium.io/
 Author: Isaac Murchie
@@ -25,6 +25,7 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: selenium~=4.12
 
 # Appium Python Client
 
@@ -75,7 +76,7 @@ download and unarchive the source tarball (Appium-Python-Client-X.X.tar.gz).
 |`2.10.0` - `2.11.1` |`4.1.0` - `4.11.2` | 3.7+ |
 |`2.2.0` - `2.9.0` |`4.1.0` - `4.9.0` | 3.7+ |
 |`2.0.0` - `2.1.4` |`4.0.0` | 3.7+ |
-|`1.0.0` - `1.1.0` |`3.x`| 3.7, 3.8 |
+|`1.0.0` - `1.3.0` |`3.x`| 3.7+ |
 |`0.52` and below|`3.x`| 2.7, 3.4 - 3.7 |
 
 The Appium Python Client depends on [Selenium Python binding](https://pypi.org/project/selenium/), thus
@@ -87,10 +88,20 @@ For example, some changes in the Selenium binding could break the Appium client.
 > to keep compatible version combinations.
 
 
+### Quick migration guide from v3 to v4
+- Removal
+    - `MultiAction` and `TouchAction` are removed. Please use W3C WebDriver actions or `mobile:` extensions
+        - [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+        - https://www.selenium.dev/documentation/webdriver/actions_api/
+        - https://www.youtube.com/watch?v=oAJ7jwMNFVU
+        - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
+        - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
+    - Deprecated `AppiumBy.WINDOWS_UI_AUTOMATION`, which has no usage right now.
+
 ### Quick migration guide from v2 to v3
 - `options` keyword argument in the `webdriver.Remote` constructor such as `XCUITestOptions` instead of `desired_capabilities`
     - Available options are https://github.com/appium/python-client/tree/master/appium/options
-        - Please check the [Usage](#usage) below as an exampple.
+        - Please check the [Usage](#usage) below as an example.
     - Not a "new" change, but the `desired_capabilities` argument has been removed since v3.
 - Replacement
     - `start_activity` method: Please use [`mobile: startActivity`](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-startactivity)
@@ -111,12 +122,6 @@ For example, some changes in the Selenium binding could break the Appium client.
     - Added `strict_ssl` to relax SSL errors such as self-signed ones
 - Deprecated
     - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions or `mobile:` extensions
-        - e.g.
-            - [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
-            - https://www.selenium.dev/documentation/webdriver/actions_api/
-            - https://www.youtube.com/watch?v=oAJ7jwMNFVU
-            - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
-            - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
     - `launch_app`, `close_app`, and `reset` are deprecated. Please read [issues#15807](https://github.com/appium/appium/issues/15807) for more details
 
 #### MultiAction/TouchAction to W3C actions

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/README.md

@@ -47,7 +47,7 @@ download and unarchive the source tarball (Appium-Python-Client-X.X.tar.gz).
 |`2.10.0` - `2.11.1` |`4.1.0` - `4.11.2` | 3.7+ |
 |`2.2.0` - `2.9.0` |`4.1.0` - `4.9.0` | 3.7+ |
 |`2.0.0` - `2.1.4` |`4.0.0` | 3.7+ |
-|`1.0.0` - `1.1.0` |`3.x`| 3.7, 3.8 |
+|`1.0.0` - `1.3.0` |`3.x`| 3.7+ |
 |`0.52` and below|`3.x`| 2.7, 3.4 - 3.7 |
 
 The Appium Python Client depends on [Selenium Python binding](https://pypi.org/project/selenium/), thus
@@ -59,10 +59,20 @@ For example, some changes in the Selenium binding could break the Appium client.
 > to keep compatible version combinations.
 
 
+### Quick migration guide from v3 to v4
+- Removal
+    - `MultiAction` and `TouchAction` are removed. Please use W3C WebDriver actions or `mobile:` extensions
+        - [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+        - https://www.selenium.dev/documentation/webdriver/actions_api/
+        - https://www.youtube.com/watch?v=oAJ7jwMNFVU
+        - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
+        - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
+    - Deprecated `AppiumBy.WINDOWS_UI_AUTOMATION`, which has no usage right now.
+
 ### Quick migration guide from v2 to v3
 - `options` keyword argument in the `webdriver.Remote` constructor such as `XCUITestOptions` instead of `desired_capabilities`
     - Available options are https://github.com/appium/python-client/tree/master/appium/options
-        - Please check the [Usage](#usage) below as an exampple.
+        - Please check the [Usage](#usage) below as an example.
     - Not a "new" change, but the `desired_capabilities` argument has been removed since v3.
 - Replacement
     - `start_activity` method: Please use [`mobile: startActivity`](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-startactivity)
@@ -83,12 +93,6 @@ For example, some changes in the Selenium binding could break the Appium client.
     - Added `strict_ssl` to relax SSL errors such as self-signed ones
 - Deprecated
     - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions or `mobile:` extensions
-        - e.g.
-            - [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
-            - https://www.selenium.dev/documentation/webdriver/actions_api/
-            - https://www.youtube.com/watch?v=oAJ7jwMNFVU
-            - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
-            - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
     - `launch_app`, `close_app`, and `reset` are deprecated. Please read [issues#15807](https://github.com/appium/appium/issues/15807) for more details
 
 #### MultiAction/TouchAction to W3C actions

appium_python_client-4.0.1/appium/version.py

@@ -0,0 +1 @@
+version = '4.0.1'

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/appium/webdriver/common/appiumby.py

@@ -17,14 +17,11 @@ from selenium.webdriver.common.by import By
 
 class AppiumBy(By):
     IOS_PREDICATE = '-ios predicate string'
-    IOS_UIAUTOMATION = '-ios uiautomation'
     IOS_CLASS_CHAIN = '-ios class chain'
     ANDROID_UIAUTOMATOR = '-android uiautomator'
     ANDROID_VIEWTAG = '-android viewtag'
     ANDROID_DATA_MATCHER = '-android datamatcher'
     ANDROID_VIEW_MATCHER = '-android viewmatcher'
-    # Deprecated
-    WINDOWS_UI_AUTOMATION = '-windows uiautomation'
     ACCESSIBILITY_ID = 'accessibility id'
     IMAGE = '-image'
     CUSTOM = '-custom'

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/appium/webdriver/extensions/clipboard.py

@@ -15,7 +15,11 @@
 import base64
 from typing import TYPE_CHECKING, Optional, cast
 
+from selenium.common.exceptions import UnknownMethodException
+
 from appium.protocols.webdriver.can_execute_commands import CanExecuteCommands
+from appium.protocols.webdriver.can_execute_scripts import CanExecuteScripts
+from appium.protocols.webdriver.can_remember_extension_presence import CanRememberExtensionPresence
 from appium.webdriver.clipboard_content_type import ClipboardContentType
 
 from ..mobilecommand import MobileCommand as Command
@@ -24,7 +28,7 @@ if TYPE_CHECKING:
     from appium.webdriver.webdriver import WebDriver
 
 
-class Clipboard(CanExecuteCommands):
+class Clipboard(CanExecuteCommands, CanExecuteScripts, CanRememberExtensionPresence):
     def set_clipboard(
         self, content: bytes, content_type: str = ClipboardContentType.PLAINTEXT, label: Optional[str] = None
     ) -> 'WebDriver':
@@ -39,13 +43,18 @@ class Clipboard(CanExecuteCommands):
         Returns:
             Union['WebDriver', 'Clipboard']: Self instance
         """
+        ext_name = 'mobile: setClipboard'
         options = {
             'content': base64.b64encode(content).decode('UTF-8'),
             'contentType': content_type,
         }
         if label:
             options['label'] = label
-        self.execute(Command.SET_CLIPBOARD, options)
+        try:
+            self.assert_extension_exists(ext_name).execute_script(ext_name, options)
+        except UnknownMethodException:
+            # TODO: Remove the fallback
+            self.mark_extension_absence(ext_name).execute(Command.SET_CLIPBOARD, options)
         return cast('WebDriver', self)
 
     def set_clipboard_text(self, text: str, label: Optional[str] = None) -> 'WebDriver':
@@ -68,9 +77,15 @@ class Clipboard(CanExecuteCommands):
                 is supported on Android
 
         Returns:
-            base64-encoded string: Clipboard content. Or return an empty string if the clipboard is empty
+            Clipboard content as bytearray. Or empty bytes if the clipboard is empty
         """
-        base64_str = self.execute(Command.GET_CLIPBOARD, {'contentType': content_type})['value']
+        ext_name = 'mobile: getClipboard'
+        options = {'contentType': content_type}
+        try:
+            base64_str = self.assert_extension_exists(ext_name).execute_script(ext_name, options)
+        except UnknownMethodException:
+            # TODO: Remove the fallback
+            base64_str = self.mark_extension_absence(ext_name).execute(Command.GET_CLIPBOARD, options)['value']
         return base64.b64decode(base64_str)
 
     def get_clipboard_text(self) -> str:

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/appium/webdriver/webdriver.py

@@ -118,7 +118,7 @@ class ExtensionBase:
                 def add_command(self):
                     return ('post', 'session/$sessionId/path/to/your/custom/url')
 
-            driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps,
+            driver = webdriver.Remote('http://localhost:4723/wd/hub', options=options,
                 extensions=[YourCustomCommand])
 
             # Then, the driver sends a post request to `session/$sessionId/path/to/your/custom/url`
@@ -126,7 +126,7 @@ class ExtensionBase:
             driver.custom_method_name({'dummy_arg': 'as a value'})
 
 
-        When you customize the URL dinamically with element id.
+        When you customize the URL dynamically with element id.
 
             class CustomURLCommand(ExtensionBase):
                 def method_name(self):
@@ -138,9 +138,9 @@ class ExtensionBase:
                 def add_command(self):
                     return ('GET', 'session/$sessionId/path/to/your/custom/$id/url')
 
-            driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps,
+            driver = webdriver.Remote('http://localhost:4723/wd/hub', options=options,
                 extensions=[YourCustomCommand])
-            element = driver.find_elemeent(by=AppiumBy.ACCESSIBILITY_ID, value='id')
+            element = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='id')
 
             # Then, the driver calls a get request to `session/$sessionId/path/to/your/custom/$id/url`
             # with replacing the `$id` with the given `element.id`
@@ -240,12 +240,10 @@ class WebDriver(
             self._update_command_executor(keep_alive=keep_alive)
 
         # add new method to the `find_by_*` pantheon
-        By.IOS_UIAUTOMATION = AppiumBy.IOS_UIAUTOMATION
         By.IOS_PREDICATE = AppiumBy.IOS_PREDICATE
         By.IOS_CLASS_CHAIN = AppiumBy.IOS_CLASS_CHAIN
         By.ANDROID_UIAUTOMATOR = AppiumBy.ANDROID_UIAUTOMATOR
         By.ANDROID_VIEWTAG = AppiumBy.ANDROID_VIEWTAG
-        By.WINDOWS_UI_AUTOMATION = AppiumBy.WINDOWS_UI_AUTOMATION
         By.ACCESSIBILITY_ID = AppiumBy.ACCESSIBILITY_ID
         By.IMAGE = AppiumBy.IMAGE
         By.CUSTOM = AppiumBy.CUSTOM

appium_python_client-4.0.1/docs/requirements.txt

@@ -0,0 +1,2 @@
+sphinx >= 4.0, < 7.0
+sphinx_rtd_theme < 3.0

{Appium-Python-Client-3.2.1 → appium_python_client-4.0.1}/docs/webdriver.common.rst

@@ -12,22 +12,6 @@ webdriver.common.mobileby module
    :undoc-members:
    :show-inheritance:
 
-webdriver.common.multi\_action module
--------------------------------------
-
-.. automodule:: webdriver.common.multi_action
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-webdriver.common.touch\_action module
--------------------------------------
-
-.. automodule:: webdriver.common.touch_action
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
 Module contents
 ---------------
 

Appium-Python-Client-3.2.1/appium/version.py

@@ -1 +0,0 @@
-version = '3.2.1'

Appium-Python-Client-3.2.1/appium/webdriver/common/multi_action.py

@@ -1,99 +0,0 @@
-#!/usr/bin/env python
-
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-# The Selenium team implemented something like the Multi Action API in the form of
-# "action chains" (https://code.google.com/p/selenium/source/browse/py/selenium/webdriver/common/action_chains.py).
-# These do not quite work for this situation, and do not allow for ad hoc action
-# chaining as the spec requires.
-
-import copy
-import warnings
-from typing import TYPE_CHECKING, Dict, List, Optional, Union
-
-from appium.webdriver.mobilecommand import MobileCommand as Command
-
-if TYPE_CHECKING:
-    from appium.webdriver.common.touch_action import TouchAction
-    from appium.webdriver.webdriver import WebDriver
-    from appium.webdriver.webelement import WebElement
-
-
-class MultiAction:
-    """
-    deprecated:: 2.0.0
-        Please use W3C actions instead: https://github.com/appium/python-client?tab=readme-ov-file#multiactiontouchaction-to-w3c-actions
-    """
-
-    def __init__(self, driver: 'WebDriver', element: Optional['WebElement'] = None) -> None:
-        warnings.warn(
-            '[Deprecated] \'MultiAction\' action is deprecated. Please use W3C actions instead.', DeprecationWarning
-        )
-
-        self._driver = driver
-        self._element = element
-        self._touch_actions: List['TouchAction'] = []
-
-    def add(self, *touch_actions: 'TouchAction') -> 'MultiAction':
-        """Add TouchAction objects to the MultiAction, to be performed later.
-
-        Args:
-            touch_actions: one or more TouchAction objects describing a chain of actions to be performed by one finger
-
-        Usage:
-            | a1 = TouchAction(driver)
-            | a1.press(el1).move_to(el2).release()
-            | a2 = TouchAction(driver)
-            | a2.press(el2).move_to(el1).release()
-            | MultiAction(driver).add(a1, a2)
-
-        Returns:
-            `MultiAction`: Self instance
-        """
-        for touch_action in touch_actions:
-            if self._touch_actions is None:
-                self._touch_actions = []
-
-            self._touch_actions.append(copy.copy(touch_action))
-
-        return self
-
-    def perform(self) -> 'MultiAction':
-        """Perform the actions stored in the object.
-
-        Usage:
-            | a1 = TouchAction(driver)
-            | a1.press(el1).move_to(el2).release()
-            | a2 = TouchAction(driver)
-            | a2.press(el2).move_to(el1).release()
-            | MultiAction(driver).add(a1, a2).perform()
-
-        Returns:
-            `MultiAction`: Self instance
-        """
-        self._driver.execute(Command.MULTI_ACTION, self.json_wire_gestures)
-
-        # clean up and be ready for the next batch
-        self._touch_actions = []
-
-        return self
-
-    @property
-    def json_wire_gestures(self) -> Dict[str, Union[List, str]]:
-        actions = []
-        for action in self._touch_actions:
-            actions.append(action.json_wire_gestures)
-        if self._element is not None:
-            return {'actions': actions, 'elementId': self._element.id}
-        return {'actions': actions}