Appium-Python-Client 3.1.1__tar.gz → 3.2.0__tar.gz

{Appium-Python-Client-3.1.1 → Appium-Python-Client-3.2.0}/Appium_Python_Client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Appium-Python-Client
-Version: 3.1.1
+Version: 3.2.0
 Summary: Python client for Appium
 Home-page: http://appium.io/
 Author: Isaac Murchie
@@ -110,10 +110,10 @@ For example, some changes in the Selenium binding could break the Appium client.
         - Please check each behavior. Their behaviors could slightly differ.
     - Added `strict_ssl` to relax SSL errors such as self-signed ones
 - Deprecated
-    - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions.
+    - `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/support_packages/mouse_and_keyboard_actions_in_detail/
+            - 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
@@ -125,8 +125,10 @@ On UIA2, some elements can be handled with `touch` pointer action instead of the
 For example, the below action builder is to replace the default one with the `touch` pointer action.
 
 ```python
+from selenium.webdriver import ActionChains
 from selenium.webdriver.common.actions import interaction
 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
@@ -139,6 +141,9 @@ actions.w3c_actions.pointer_action.release()
 actions.perform()
 ```
 
+- [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+- https://www.selenium.dev/documentation/webdriver/actions_api/
+
 ## Usage
 
 The Appium Python Client is fully compliant with the WebDriver Protocol

{Appium-Python-Client-3.1.1 → Appium-Python-Client-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Appium-Python-Client
-Version: 3.1.1
+Version: 3.2.0
 Summary: Python client for Appium
 Home-page: http://appium.io/
 Author: Isaac Murchie
@@ -110,10 +110,10 @@ For example, some changes in the Selenium binding could break the Appium client.
         - Please check each behavior. Their behaviors could slightly differ.
     - Added `strict_ssl` to relax SSL errors such as self-signed ones
 - Deprecated
-    - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions.
+    - `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/support_packages/mouse_and_keyboard_actions_in_detail/
+            - 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
@@ -125,8 +125,10 @@ On UIA2, some elements can be handled with `touch` pointer action instead of the
 For example, the below action builder is to replace the default one with the `touch` pointer action.
 
 ```python
+from selenium.webdriver import ActionChains
 from selenium.webdriver.common.actions import interaction
 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
@@ -139,6 +141,9 @@ actions.w3c_actions.pointer_action.release()
 actions.perform()
 ```
 
+- [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+- https://www.selenium.dev/documentation/webdriver/actions_api/
+
 ## Usage
 
 The Appium Python Client is fully compliant with the WebDriver Protocol

{Appium-Python-Client-3.1.1 → Appium-Python-Client-3.2.0}/README.md

@@ -82,10 +82,10 @@ For example, some changes in the Selenium binding could break the Appium client.
         - Please check each behavior. Their behaviors could slightly differ.
     - Added `strict_ssl` to relax SSL errors such as self-signed ones
 - Deprecated
-    - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions.
+    - `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/support_packages/mouse_and_keyboard_actions_in_detail/
+            - 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
@@ -97,8 +97,10 @@ On UIA2, some elements can be handled with `touch` pointer action instead of the
 For example, the below action builder is to replace the default one with the `touch` pointer action.
 
 ```python
+from selenium.webdriver import ActionChains
 from selenium.webdriver.common.actions import interaction
 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
@@ -111,6 +113,9 @@ actions.w3c_actions.pointer_action.release()
 actions.perform()
 ```
 
+- [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+- https://www.selenium.dev/documentation/webdriver/actions_api/
+
 ## Usage
 
 The Appium Python Client is fully compliant with the WebDriver Protocol

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

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

{Appium-Python-Client-3.1.1 → Appium-Python-Client-3.2.0}/appium/webdriver/common/multi_action.py

@@ -33,7 +33,7 @@ if TYPE_CHECKING:
 class MultiAction:
     """
     deprecated:: 2.0.0
-        Please use W3C actions instead: http://appium.io/docs/en/commands/interactions/actions/
+        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:
@@ -45,7 +45,7 @@ class MultiAction:
         self._element = element
         self._touch_actions: List['TouchAction'] = []
 
-    def add(self, *touch_actions: 'TouchAction') -> None:
+    def add(self, *touch_actions: 'TouchAction') -> 'MultiAction':
         """Add TouchAction objects to the MultiAction, to be performed later.
 
         Args:
@@ -67,6 +67,8 @@ class MultiAction:
 
             self._touch_actions.append(copy.copy(touch_action))
 
+        return self
+
     def perform(self) -> 'MultiAction':
         """Perform the actions stored in the object.
 

{Appium-Python-Client-3.1.1 → Appium-Python-Client-3.2.0}/appium/webdriver/common/touch_action.py

@@ -37,7 +37,7 @@ if TYPE_CHECKING:
 class TouchAction:
     """
     deprecated:: 2.0.0
-        Please use W3C actions instead: http://appium.io/docs/en/commands/interactions/actions/
+        Please use W3C actions instead: https://github.com/appium/python-client?tab=readme-ov-file#multiactiontouchaction-to-w3c-actions
     """
 
     def __init__(self, driver: Optional['WebDriver'] = None):

{Appium-Python-Client-3.1.1 → Appium-Python-Client-3.2.0}/appium/webdriver/extensions/action_helpers.py

@@ -61,12 +61,15 @@ class ActionHelpers:
         actions.perform()
         return cast('WebDriver', self)
 
-    def drag_and_drop(self, origin_el: WebElement, destination_el: WebElement) -> 'WebDriver':
+    def drag_and_drop(
+        self, origin_el: WebElement, destination_el: WebElement, pause: Optional[float] = None
+    ) -> 'WebDriver':
         """Drag the origin element to the destination element
 
         Args:
             origin_el: the element to drag
             destination_el: the element to drag to
+            pause: how long the action pauses before moving after the tap and hold, in float seconds.
 
         Returns:
             Union['WebDriver', 'ActionHelpers']: Self instance
@@ -74,6 +77,8 @@ class ActionHelpers:
         actions = ActionChains(self)
         # 'mouse' pointer action
         actions.w3c_actions.pointer_action.click_and_hold(origin_el)
+        if pause is not None and pause > 0:
+            actions.w3c_actions.pointer_action.pause(pause)
         actions.w3c_actions.pointer_action.move_to(destination_el)
         actions.w3c_actions.pointer_action.release()
         actions.perform()

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

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