Appium-Python-Client 6.0.12__tar.gz → 6.1.1__tar.gz

{appium_python_client-6.0.12 → appium_python_client-6.1.1}/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 <!-- version list -->
 
+## v6.1.1 (2026-10-31)
+
+### Bug Fixes
+
+- Keep the server's error output when it ignores terminate
+  ([#1342](https://github.com/appium/python-client/pull/1342),
+  [`4442366`](https://github.com/appium/python-client/commit/4442366d3bd5b82a063d38836054070c3720ccab))
+
+- Prevent AppiumService.start from hanging when the server fails to start
+  ([#1342](https://github.com/appium/python-client/pull/1342),
+  [`4442366`](https://github.com/appium/python-client/commit/4442366d3bd5b82a063d38836054070c3720ccab))
+
+
+## v6.1.0 (2026-10-31)
+
+### Features
+
+- Mark ActionHelpers interaction shortcuts as deprecated
+  ([#1333](https://github.com/appium/python-client/pull/1333),
+  [`cd224d9`](https://github.com/appium/python-client/commit/cd224d96597c2134776029b6697f43adce0c49c9))
+
+
 ## v6.0.12 (2026-10-31)
 
 ### Bug Fixes

{appium_python_client-6.0.12 → appium_python_client-6.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Appium-Python-Client
-Version: 6.0.12
+Version: 6.1.1
 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 → appium_python_client-6.1.1}/README.md

@@ -124,10 +124,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
@@ -136,7 +138,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 → appium_python_client-6.1.1}/appium/webdriver/appium_service.py

@@ -27,6 +27,7 @@ from selenium.webdriver.remote.remote_connection import urllib3
 DEFAULT_HOST = '127.0.0.1'
 DEFAULT_PORT = 4723
 STARTUP_TIMEOUT_MS = 60000
+STOP_TIMEOUT_SEC = 5.5
 STATE_CHECK_INTERVAL_MS = 500
 MAIN_SCRIPT_PATH = 'appium/build/lib/main.js'
 STATUS_URL = '/status'
@@ -124,15 +125,26 @@ class AppiumService:
             error_msg = startup_failure_msg
         if error_msg is not None:
             if stderr == sp.PIPE and self._process.stderr is not None:
-                # noinspection PyUnresolvedReferences
-                err_output = self._process.stderr.read()
+                # The server might still be running, for example if it does not listen on the expected URL.
+                # Reading its stderr before the process exits would block forever, so terminate it first.
+                self._process.terminate()
+                try:
+                    _, err_output = self._process.communicate(timeout=STOP_TIMEOUT_SEC)
+                except sp.TimeoutExpired:
+                    # The server ignored the termination request. Kill it, so its error output is not lost.
+                    self._process.kill()
+                    try:
+                        _, err_output = self._process.communicate(timeout=STOP_TIMEOUT_SEC)
+                    except sp.TimeoutExpired as e:
+                        # Another process might still hold stderr open. Keep the output read so far.
+                        err_output = e.stderr or b''
                 if err_output:
                     error_msg += f'\nOriginal error: {str(err_output)}'
             self.stop()
             raise AppiumServiceError(error_msg)
         return self._process
 
-    def stop(self, timeout: float = 5.5) -> bool:
+    def stop(self, timeout: float = STOP_TIMEOUT_SEC) -> bool:
         """Stops Appium service if it is running.
 
         The call will be ignored if the service is not running

{appium_python_client-6.0.12 → appium_python_client-6.1.1}/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 → appium_python_client-6.1.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "Appium-Python-Client"
 description = "Python client for Appium"
-version = "6.0.12"
+version = "6.1.1"
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE"]

{appium_python_client-6.0.12 → appium_python_client-6.1.1}/uv.lock

@@ -27,7 +27,7 @@ wheels = [
 
 [[package]]
 name = "appium-python-client"
-version = "6.0.12"
+version = "6.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "selenium" },