Skip to content

Commit 4d8db65

Browse files
authored
feat: remove MultiAction and TouchAction (#960)
BREAKING CHANGE: Remove MultiAction and TouchAction as non-w3c WebDriver-defined methods. Please use w3c actions instead.
1 parent b30e0b0 commit 4d8db65

File tree

9 files changed

+10
-782
lines changed

9 files changed

+10
-782
lines changed

README.md

+9-6
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,15 @@ For example, some changes in the Selenium binding could break the Appium client.
5959
> to keep compatible version combinations.
6060

6161

62+
### Quick migration guide from v3 to v4
63+
- Removal
64+
- `MultiAction` and `TouchAction` are removed. Please use W3C WebDriver actions or `mobile:` extensions
65+
- [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
66+
- https://www.selenium.dev/documentation/webdriver/actions_api/
67+
- https://www.youtube.com/watch?v=oAJ7jwMNFVU
68+
- https://appiumpro.com/editions/30-ios-specific-touch-action-methods
69+
- https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
70+
6271
### Quick migration guide from v2 to v3
6372
- `options` keyword argument in the `webdriver.Remote` constructor such as `XCUITestOptions` instead of `desired_capabilities`
6473
- Available options are https://github.com/appium/python-client/tree/master/appium/options
@@ -83,12 +92,6 @@ For example, some changes in the Selenium binding could break the Appium client.
8392
- Added `strict_ssl` to relax SSL errors such as self-signed ones
8493
- Deprecated
8594
- `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions or `mobile:` extensions
86-
- e.g.
87-
- [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
88-
- https://www.selenium.dev/documentation/webdriver/actions_api/
89-
- https://www.youtube.com/watch?v=oAJ7jwMNFVU
90-
- https://appiumpro.com/editions/30-ios-specific-touch-action-methods
91-
- https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
9295
- `launch_app`, `close_app`, and `reset` are deprecated. Please read [issues#15807](https://github.com/appium/appium/issues/15807) for more details
9396

9497
#### MultiAction/TouchAction to W3C actions

appium/webdriver/common/multi_action.py

-99
This file was deleted.

appium/webdriver/common/touch_action.py

-218
This file was deleted.

ci-jobs/functional_test.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,6 @@ jobs:
8484
name: 'func_test_android8'
8585
vmImage: ${{ parameters.vmImage }}
8686
pytestOpt: ${{ parameters.pytestOpt }}
87-
testFiles: 'network_connection_tests.py log_event_tests.py activities_tests.py hw_actions_tests.py touch_action_tests.py'
87+
testFiles: 'network_connection_tests.py log_event_tests.py activities_tests.py hw_actions_tests.py'
8888
sdkVer: ${{ parameters.androidSdkVer }}
8989
CI: ${{ parameters.ci }}

docs/webdriver.common.rst

-16
Original file line numberDiff line numberDiff line change
@@ -12,22 +12,6 @@ webdriver.common.mobileby module
1212
:undoc-members:
1313
:show-inheritance:
1414

15-
webdriver.common.multi\_action module
16-
-------------------------------------
17-
18-
.. automodule:: webdriver.common.multi_action
19-
:members:
20-
:undoc-members:
21-
:show-inheritance:
22-
23-
webdriver.common.touch\_action module
24-
-------------------------------------
25-
26-
.. automodule:: webdriver.common.touch_action
27-
:members:
28-
:undoc-members:
29-
:show-inheritance:
30-
3115
Module contents
3216
---------------
3317

0 commit comments

Comments
 (0)