Appium-Python-Client 6.0.12__py3-none-any.whl → 6.1.0__py3-none-any.whl

appium/webdriver/extensions/action_helpers.py

@@ -19,7 +19,7 @@ from selenium.webdriver.common.actions import interaction
 from selenium.webdriver.common.actions.action_builder import ActionBuilder
 from selenium.webdriver.common.actions.mouse_button import MouseButton
 from selenium.webdriver.common.actions.pointer_input import PointerInput
-from typing_extensions import Self
+from typing_extensions import Self, deprecated
 
 from appium.webdriver.webelement import WebElement
 
@@ -29,9 +29,14 @@ if TYPE_CHECKING:
 
 
 class ActionHelpers:
+    @deprecated('Please use W3C actions (ActionChains/ActionBuilder) or mobile: gesture extensions instead.')
     def scroll(self, origin_el: WebElement, destination_el: WebElement, duration: int | None = None) -> Self:
         """Scrolls from one element to another
 
+        .. deprecated::
+            Please use W3C actions (`ActionChains` / `ActionBuilder`) or driver-specific
+            `mobile:` gesture extensions instead.
+
         Args:
             origin_el: the element from which to begin scrolling (center of element)
             destination_el: the element to scroll to (center of element)
@@ -63,9 +68,14 @@ class ActionHelpers:
         actions.perform()
         return self
 
+    @deprecated('Please use W3C actions (ActionChains/ActionBuilder) or mobile: gesture extensions instead.')
     def drag_and_drop(self, origin_el: WebElement, destination_el: WebElement, pause: float | None = None) -> Self:
         """Drag the origin element to the destination element
 
+        .. deprecated::
+            Please use W3C actions (`ActionChains` / `ActionBuilder`) or driver-specific
+            `mobile:` gesture extensions instead.
+
         Args:
             origin_el: the element to drag
             destination_el: the element to drag to
@@ -84,10 +94,15 @@ class ActionHelpers:
         actions.perform()
         return self
 
+    @deprecated('Please use W3C actions (ActionChains/ActionBuilder) or mobile: gesture extensions instead.')
     def tap(self, positions: list[tuple[int, int]], duration: int | None = None) -> Self:
         """Taps on an particular place with up to five fingers, holding for a
         certain time
 
+        .. deprecated::
+            Please use W3C actions (`ActionChains` / `ActionBuilder`) or driver-specific
+            `mobile:` gesture extensions instead.
+
         Args:
             positions: an array of tuples representing the x/y coordinates of
                 the fingers to tap. Length can be up to five.
@@ -132,9 +147,14 @@ class ActionHelpers:
             actions.perform()
         return self
 
+    @deprecated('Please use W3C actions (ActionChains/ActionBuilder) or mobile: gesture extensions instead.')
     def swipe(self, start_x: int, start_y: int, end_x: int, end_y: int, duration: int = 0) -> Self:
         """Swipe from one point to another point, for an optional duration.
 
+        .. deprecated::
+            Please use W3C actions (`ActionChains` / `ActionBuilder`) or driver-specific
+            `mobile:` gesture extensions instead.
+
         Args:
             start_x: x-coordinate at which to start
             start_y: y-coordinate at which to start
@@ -161,9 +181,14 @@ class ActionHelpers:
         actions.perform()
         return self
 
+    @deprecated('Please use W3C actions (ActionChains/ActionBuilder) or mobile: gesture extensions instead.')
     def flick(self, start_x: int, start_y: int, end_x: int, end_y: int) -> Self:
         """Flick from one point to another point.
 
+        .. deprecated::
+            Please use W3C actions (`ActionChains` / `ActionBuilder`) or driver-specific
+            `mobile:` gesture extensions instead.
+
         Args:
             start_x: x-coordinate at which to start
             start_y: y-coordinate at which to start

{appium_python_client-6.0.12.dist-info → appium_python_client-6.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Appium-Python-Client
-Version: 6.0.12
+Version: 6.1.0
 Summary: Python client for Appium
 Project-URL: Homepage, https://appium.io/
 Project-URL: Repository, https://github.com/appium/python-client
@@ -152,10 +152,12 @@ For example, some changes in the Selenium binding could break the Appium client.
     - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions or `mobile:` extensions
     - `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
+#### MultiAction/TouchAction and ActionHelpers Shortcuts to W3C Actions
+
+The interaction shortcut methods on `ActionHelpers` (`scroll`, `drag_and_drop`, `tap`, `swipe`, and `flick`) are deprecated because gesture behavior varies across drivers and pointer types (for example, Android UiAutomator2 handles `POINTER_TOUCH` and `POINTER_MOUSE` inputs differently in the underlying UIAutomator framework). Build W3C WebDriver actions directly with `ActionChains` / `ActionBuilder` instead.
 
 Some elements can be handled with `touch` pointer action instead of the default `mouse` pointer action in the Selenium Python client.
-For example, the below action builder is to replace the default one with the `touch` pointer action.
+For example, the below action builder is to replace the default one with the `touch` pointer action:
 
 ```python
 from selenium.webdriver import ActionChains
@@ -164,7 +166,7 @@ from selenium.webdriver.common.actions.action_builder import ActionBuilder
 from selenium.webdriver.common.actions.pointer_input import PointerInput
 
 actions = ActionChains(driver)
-# override as 'touch' pointer action
+# override as 'touch' pointer action (or use interaction.POINTER_MOUSE for mouse input)
 actions.w3c_actions = ActionBuilder(driver, mouse=PointerInput(interaction.POINTER_TOUCH, 'touch'))
 actions.w3c_actions.pointer_action.move_to_location(start_x, start_y)
 actions.w3c_actions.pointer_action.pointer_down()

{appium_python_client-6.0.12.dist-info → appium_python_client-6.1.0.dist-info}/RECORD

@@ -287,7 +287,7 @@ appium/webdriver/webelement.py,sha256=ewBkxaZiJtmhRoKjQk317WjewansQ6tpm3JePSv1pQ
 appium/webdriver/common/__init__.py,sha256=4MapoJ3p5LiP0AsHMgL2xoPTIFno4dcH1GSoxaZzv4w,623
 appium/webdriver/common/appiumby.py,sha256=1sFzgJht8v9pO0fG-uK1jgbb8zMJwfBy3LJH15OPqq8,1785
 appium/webdriver/extensions/__init__.py,sha256=wSUl6yC2TJNla7xbHXkCfn9J1LpQs9UIx8oOs6V8kZA,567
-appium/webdriver/extensions/action_helpers.py,sha256=LPpEia81XoMMt6ENdP8hvY1WOoy7ST5tzN1NuzQQv-g,8006
+appium/webdriver/extensions/action_helpers.py,sha256=yK_SDJCl-PeepC3C-zXJnfCLkcFwRz3NB_SH4JicFTw,9388
 appium/webdriver/extensions/applications.py,sha256=KnRD9-JilgYtBuy8dik2iGI5GeS2RPQws2BSdKL9HDo,6575
 appium/webdriver/extensions/clipboard.py,sha256=G0qvK5I5DP87IR8A5ICMC-_mtEPktSCOPKif-RZwX2M,3470
 appium/webdriver/extensions/context.py,sha256=Ldhyld4n_JRu9YhgnIOtF-qZQYsXlYrjdYHStcIV2jA,1994
@@ -319,7 +319,7 @@ appium/webdriver/extensions/flutter_integration/__init__.py,sha256=wSUl6yC2TJNla
 appium/webdriver/extensions/flutter_integration/flutter_commands.py,sha256=FwNqIykRyMAU8-344GTlceBOxLbS-bA9bfGX4iJpHxw,11985
 appium/webdriver/extensions/flutter_integration/flutter_finder.py,sha256=HH9vGAouJuHzp29Jam_lQGrh67PDq6MxU5Ifewf7C5w,2164
 appium/webdriver/extensions/flutter_integration/scroll_directions.py,sha256=CkOv7k21SMe-h2-EYSZ6MBKBGTRC1csQ-tuowHgMn0E,85
-appium_python_client-6.0.12.dist-info/METADATA,sha256=4-B6Vfcd_WKqdqJytd1zySO73Oukatozsdyd3dPEKww,21274
-appium_python_client-6.0.12.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-appium_python_client-6.0.12.dist-info/licenses/LICENSE,sha256=QxeKfXNmPWCfFyrXiwdVzMFPFMK0nlBrKhYLUoIcqhk,11384
-appium_python_client-6.0.12.dist-info/RECORD,,
+appium_python_client-6.1.0.dist-info/METADATA,sha256=lnYvisOqH_pImigF_8hYtOb-kSMOLzqzSnpE2k7oLS4,21766
+appium_python_client-6.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+appium_python_client-6.1.0.dist-info/licenses/LICENSE,sha256=QxeKfXNmPWCfFyrXiwdVzMFPFMK0nlBrKhYLUoIcqhk,11384
+appium_python_client-6.1.0.dist-info/RECORD,,