Appium-Python-Client 6.0.7__tar.gz → 6.0.9__tar.gz

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/.github/workflows/functional-test.yml

@@ -67,7 +67,7 @@ jobs:
         defaults write com.apple.iphonesimulator PasteboardAutomaticSync -bool false
         open -Fn "$(xcode-select --print-path)/Applications/Simulator.app"
     - name: Prepare iOS simulator
-      uses: futureware-tech/simulator-action@v5
+      uses: futureware-tech/simulator-action@v6
       with:
         model: ${{ env.IPHONE_MODEL }}
         os_version: ${{ env.IOS_VERSION }}
@@ -83,7 +83,7 @@ jobs:
         python-version: 3.14
 
     - name: Set up uv
-      uses: astral-sh/setup-uv@v10.1.0
+      uses: astral-sh/setup-uv@v10.3.0
       with:
         enable-cache: true
         python-version: '3.14'
@@ -129,7 +129,7 @@ jobs:
     steps:
     - uses: actions/checkout@v7
 
-    - uses: actions/setup-java@v6.0.1
+    - uses: actions/setup-java@v6.1.0
       with:
         distribution: 'temurin'
         java-version: '17'
@@ -190,7 +190,7 @@ jobs:
         python-version: 3.14
 
     - name: Set up uv
-      uses: astral-sh/setup-uv@v10.1.0
+      uses: astral-sh/setup-uv@v10.3.0
       with:
         enable-cache: true
         python-version: '3.14'
@@ -253,7 +253,7 @@ jobs:
 
     - uses: actions/checkout@v7
 
-    - uses: actions/setup-java@v6.0.1
+    - uses: actions/setup-java@v6.1.0
       if: matrix.e2e-tests == 'flutter-android'
       with:
         distribution: 'zulu'
@@ -306,7 +306,7 @@ jobs:
         log_file: appium-${{ matrix.e2e-tests }}.log
 
     - name: Set up uv
-      uses: astral-sh/setup-uv@v10.1.0
+      uses: astral-sh/setup-uv@v10.3.0
       with:
         enable-cache: true
         python-version: '3.14'
@@ -328,7 +328,7 @@ jobs:
         defaults write com.apple.iphonesimulator PasteboardAutomaticSync -bool false
         open -Fn "$(xcode-select --print-path)/Applications/Simulator.app"
 
-    - uses: futureware-tech/simulator-action@v5
+    - uses: futureware-tech/simulator-action@v6
       if: matrix.e2e-tests == 'flutter-ios'
       with:
         # https://github.com/actions/runner-images/blob/main/images/macos/macos-14-arm64-Readme.md

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/.github/workflows/unit-test.yml

@@ -25,7 +25,7 @@ jobs:
       with:
         python-version: '3.14'
     - name: Set up uv
-      uses: astral-sh/setup-uv@v10.1.0
+      uses: astral-sh/setup-uv@v10.3.0
       with:
         enable-cache: true
         python-version: '3.14'
@@ -39,7 +39,7 @@ jobs:
     timeout-minutes: 20
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
     steps:
     - uses: actions/checkout@v7
     - name: Set up Python ${{ matrix.python-version }}
@@ -47,7 +47,7 @@ jobs:
       with:
         python-version: ${{ matrix.python-version }}
     - name: Set up uv
-      uses: astral-sh/setup-uv@v10.1.0
+      uses: astral-sh/setup-uv@v10.3.0
       with:
         enable-cache: true
         python-version: ${{ matrix.python-version }}

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/CHANGELOG.md

@@ -2,6 +2,81 @@
 
 <!-- version list -->
 
+## v6.0.9 (2026-10-24)
+
+### Bug Fixes
+
+- **webelement**: Preserve default locator strategy in webelement type hints
+  ([#1309](https://github.com/appium/python-client/pull/1309),
+  [`efb4085`](https://github.com/appium/python-client/commit/efb4085b03a40c58dd1aa628cab31be50bb4dd5c))
+
+
+## v6.0.8 (2026-10-20)
+
+### Bug Fixes
+
+- **android**: Send the gsmVoice and powerAc execute method names
+  ([#1320](https://github.com/appium/python-client/pull/1320),
+  [`cd946b7`](https://github.com/appium/python-client/commit/cd946b71b599c47957b57279ef964c31aa873b68))
+
+- **android**: Send the gsmVoice and powerAc execute method names
+  ([#1320](https://github.com/appium/python-client/pull/1320),
+  [`547a712`](https://github.com/appium/python-client/commit/547a712b0e0ecf13f4185b8f950b1a9e6b7ba0d7))
+
+### Chores
+
+- Add support python3.15 ([#1326](https://github.com/appium/python-client/pull/1326),
+  [`3c2b1b0`](https://github.com/appium/python-client/commit/3c2b1b006c1aa96d7ea847eab64ba91714e4c548))
+
+### Continuous Integration
+
+- **deps**: Bump actions/setup-java from 6.0.1 to 6.1.0
+  ([#1325](https://github.com/appium/python-client/pull/1325),
+  [`b6311fe`](https://github.com/appium/python-client/commit/b6311feb681dee679f03543c6add4e481b1a76b0))
+
+- **deps**: Bump astral-sh/setup-uv from 10.1.0 to 10.2.0
+  ([#1312](https://github.com/appium/python-client/pull/1312),
+  [`385e953`](https://github.com/appium/python-client/commit/385e95339ee31ce995a5c37f4503b7e2eeece756))
+
+- **deps**: Bump astral-sh/setup-uv from 10.2.0 to 10.3.0
+  ([#1324](https://github.com/appium/python-client/pull/1324),
+  [`9f36595`](https://github.com/appium/python-client/commit/9f365953ab5d4a5988ff0d5065e833553a66d39e))
+
+- **deps**: Bump futureware-tech/simulator-action from 5 to 6
+  ([#1321](https://github.com/appium/python-client/pull/1321),
+  [`8b1ba0d`](https://github.com/appium/python-client/commit/8b1ba0d9e56764eefd3f879218038d3bec443188))
+
+- **deps**: Bump selenium from 4.48.0 to 4.51.0
+  ([#1323](https://github.com/appium/python-client/pull/1323),
+  [`62513dd`](https://github.com/appium/python-client/commit/62513ddb9db29de9b40dc0dbe500b2f29b8af812))
+
+- **deps**: Bump virtualenv from 20.36.1 to 21.7.13
+  ([#1319](https://github.com/appium/python-client/pull/1319),
+  [`4a4c46b`](https://github.com/appium/python-client/commit/4a4c46b64812e10885d80db3f60fbea9ea9a7b67))
+
+- **deps-dev**: Bump ruff from 0.16.6 to 0.16.7
+  ([#1304](https://github.com/appium/python-client/pull/1304),
+  [`49edf55`](https://github.com/appium/python-client/commit/49edf555409e1ca3a1727f934a5887b1903f04d7))
+
+- **deps-dev**: Bump ruff from 0.16.7 to 0.16.8
+  ([#1310](https://github.com/appium/python-client/pull/1310),
+  [`95f4c05`](https://github.com/appium/python-client/commit/95f4c056a370a1bbeb83123cf9ab7e8d8a6564dd))
+
+- **deps-dev**: Bump ruff from 0.16.8 to 0.17.0
+  ([#1322](https://github.com/appium/python-client/pull/1322),
+  [`705f9d1`](https://github.com/appium/python-client/commit/705f9d1523f3990db9d5b1f4ccc96a0bee2cb580))
+
+### Documentation
+
+- Update driver links to docs sites ([#1328](https://github.com/appium/python-client/pull/1328),
+  [`d43a9f4`](https://github.com/appium/python-client/commit/d43a9f4230a1781bf32827b677f35713565ad772))
+
+### Refactoring
+
+- Use local variable
+  ([`79d0a55`](https://github.com/appium/python-client/commit/79d0a555e9fded546cd301071ee4c48a51d0d7f7))
+
+
 ## v6.0.7 (2026-09-18)
 
 ### Bug Fixes

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Appium-Python-Client
-Version: 6.0.7
+Version: 6.0.9
 Summary: Python client for Appium
 Project-URL: Homepage, https://appium.io/
 Project-URL: Repository, https://github.com/appium/python-client
@@ -19,9 +19,10 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.10
-Requires-Dist: selenium<5.0,>=4.37.0
+Requires-Dist: selenium<5.0,>=4.51.0
 Requires-Dist: typing-extensions~=4.16
 Description-Content-Type: text/markdown
 
@@ -131,9 +132,9 @@ For example, some changes in the Selenium binding could break the Appium client.
         - 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)
+    - `start_activity` method: Please use [`mobile: startActivity`](https://appium.github.io/appium-uiautomator2-driver/latest/reference/execute-methods/#mobile-startactivity)
     - `launch_app`, `close_app` and `reset` methods: Please refer to https://github.com/appium/appium/issues/15807
-    - `available_ime_engines`, `is_ime_active`, `activate_ime_engine`, `deactivate_ime_engine` and `active_ime_engine` methods: Please use [`mobile: shell`](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-shell)
+    - `available_ime_engines`, `is_ime_active`, `activate_ime_engine`, `deactivate_ime_engine` and `active_ime_engine` methods: Please use [`mobile: shell`](https://appium.github.io/appium-uiautomator2-driver/latest/reference/execute-methods/#mobile-shell)
     - `set_value` and `set_text` methods: Please use `element.send_keys` or `send_keys` by W3C Actions
 - Removal
     - `end_test_coverage` method is no longer available

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/README.md

@@ -104,9 +104,9 @@ For example, some changes in the Selenium binding could break the Appium client.
         - 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)
+    - `start_activity` method: Please use [`mobile: startActivity`](https://appium.github.io/appium-uiautomator2-driver/latest/reference/execute-methods/#mobile-startactivity)
     - `launch_app`, `close_app` and `reset` methods: Please refer to https://github.com/appium/appium/issues/15807
-    - `available_ime_engines`, `is_ime_active`, `activate_ime_engine`, `deactivate_ime_engine` and `active_ime_engine` methods: Please use [`mobile: shell`](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-shell)
+    - `available_ime_engines`, `is_ime_active`, `activate_ime_engine`, `deactivate_ime_engine` and `active_ime_engine` methods: Please use [`mobile: shell`](https://appium.github.io/appium-uiautomator2-driver/latest/reference/execute-methods/#mobile-shell)
     - `set_value` and `set_text` methods: Please use `element.send_keys` or `send_keys` by W3C Actions
 - Removal
     - `end_test_coverage` method is no longer available

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/options/android/espresso/activity_options_option.py

@@ -34,7 +34,7 @@ class ActivityOptionsOption(SupportsCapabilities):
         """
         The mapping of custom options for the main app activity that is going to
         be started. Check
-        https://github.com/appium/appium-espresso-driver#activity-options
+        https://appium.github.io/appium-espresso-driver/latest/reference/capabilities/#activityoptions
         for more details.
         """
         self.set_capability(ACTIVITY_OPTIONS, value)

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/options/android/espresso/espresso_build_config_option.py

@@ -40,7 +40,7 @@ class EspressoBuildConfigOption(SupportsCapabilities):
         """
         This config allows to customize several important properties of
         Espresso server. Refer to
-        https://github.com/appium/appium-espresso-driver#espresso-build-config
+        https://appium.github.io/appium-espresso-driver/latest/reference/capabilities/#espressobuildconfig
         for more information on how to properly construct such config.
         """
         self.set_capability(ESPRESSO_BUILD_CONFIG, value if isinstance(value, str) else json.dumps(value, ensure_ascii=False))

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/options/android/espresso/intent_options_option.py

@@ -35,7 +35,7 @@ class IntentOptionsOption(SupportsCapabilities):
         """
         The mapping of custom options for the intent that is going to be passed
         to the main app activity. Check
-        https://github.com/appium/appium-espresso-driver#intent-options
+        https://appium.github.io/appium-espresso-driver/latest/reference/capabilities/#intentoptions
         for more details.
         """
         self.set_capability(INTENT_OPTIONS, value)

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/options/mac/mac2/base.py

@@ -56,7 +56,7 @@ class Mac2Options(
         A mapping containing either 'script' or 'command' key. The value of
         each key must be a valid AppleScript script or command to be
         executed after before Mac2Driver session is started. See
-        https://github.com/appium/appium-mac2-driver#applescript-commands-execution
+        https://appium.github.io/appium-mac2-driver/latest/reference/capabilities/#prerun
         for more details.
         """
         PrerunOption.prerun.fset(self, value)  # type: ignore
@@ -67,7 +67,7 @@ class Mac2Options(
         A mapping containing either 'script' or 'command' key. The value of
         each key must be a valid AppleScript script or command to be
         executed after Mac2Driver session is stopped. See
-        https://github.com/appium/appium-mac2-driver#applescript-commands-execution
+        https://appium.github.io/appium-mac2-driver/latest/reference/capabilities/#postrun
         for more details.
         """
         PostrunOption.postrun.fset(self, value)  # type: ignore

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/protocols/webdriver/can_find_elements.py

@@ -15,6 +15,8 @@
 from typing import TYPE_CHECKING, Protocol, runtime_checkable
 
 if TYPE_CHECKING:
+    from selenium.webdriver.common.by import By
+
     from appium.webdriver.webelement import WebElement
 
 
@@ -27,6 +29,13 @@ class CanFindElements(Protocol):
     - find_elements(by, value): Find multiple elements
     """
 
-    def find_element(self, by: str, value: str | dict | None = None) -> 'WebElement': ...
+    if TYPE_CHECKING:
+
+        def find_element(self, by: str = By.ID, value: str | dict | None = None) -> 'WebElement': ...
+
+        def find_elements(self, by: str = By.ID, value: str | dict | None = None) -> list['WebElement']: ...
+    else:
+
+        def find_element(self, by: str = 'id', value: str | dict | None = None) -> 'WebElement': ...
 
-    def find_elements(self, by: str, value: str | dict | None = None) -> list['WebElement']: ...
+        def find_elements(self, by: str = 'id', value: str | dict | None = None) -> list['WebElement']: ...

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/webdriver/extensions/android/gsm.py

@@ -113,7 +113,7 @@ class Gsm(CanExecuteCommands, CanExecuteScripts):
         Returns:
             Union['WebDriver', 'Gsm']: Self instance
         """
-        ext_name = 'mobile: gmsVoice'
+        ext_name = 'mobile: gsmVoice'
         constants = extract_const_attributes(GsmVoiceState)
         if state not in constants.values():
             logger.warning(

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/webdriver/extensions/android/power.py

@@ -47,7 +47,7 @@ class Power(CanExecuteCommands, CanExecuteScripts):
 
         Android only.
 
-        Requires the Appium driver to support the `mobile: powerAC` execute method.
+        Requires the Appium driver to support the `mobile: powerAc` execute method.
 
         Args:
             ac_state: The power ac state to be set. Use `Power.AC_OFF`, `Power.AC_ON`
@@ -59,7 +59,7 @@ class Power(CanExecuteCommands, CanExecuteScripts):
         Returns:
             Union['WebDriver', 'Power']: Self instance
         """
-        ext_name = 'mobile: powerAC'
+        ext_name = 'mobile: powerAc'
         args = {'state': ac_state}
         self.execute_script(ext_name, args)
         return self

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/webdriver/webdriver.py

@@ -457,8 +457,9 @@ class WebDriver(
                 driver.orientation = 'landscape'
         """
         allowed_values = ['LANDSCAPE', 'PORTRAIT']
-        if value.upper() in allowed_values:
-            self.execute(Command.SET_SCREEN_ORIENTATION, {'orientation': value.upper()})
+        v = value.upper()
+        if v in allowed_values:
+            self.execute(Command.SET_SCREEN_ORIENTATION, {'orientation': v})
         else:
             raise WebDriverException("You can only set the orientation to 'LANDSCAPE' and 'PORTRAIT'")
 

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/appium/webdriver/webelement.py

@@ -22,6 +22,9 @@ from typing_extensions import Self
 
 from .mobilecommand import MobileCommand as Command
 
+if TYPE_CHECKING:
+    from selenium.webdriver.common.by import By
+
 
 class WebElement(SeleniumWebElement):
     _execute: Callable
@@ -29,10 +32,10 @@ class WebElement(SeleniumWebElement):
 
     if TYPE_CHECKING:
 
-        def find_element(self, by: str, value: str | dict | None = None) -> Self:  # type: ignore[override]
+        def find_element(self, by: str = By.ID, value: str | dict | None = None) -> Self:  # type: ignore[override]
             ...
 
-        def find_elements(self, by: str, value: str | dict | None = None) -> list[Self]:  # type: ignore[override]
+        def find_elements(self, by: str = By.ID, value: str | dict | None = None) -> list[Self]:  # type: ignore[override]
             ...
 
     def get_attribute(self, name: str) -> str | dict | None:  # type: ignore[override]

{appium_python_client-6.0.7 → appium_python_client-6.0.9}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "Appium-Python-Client"
 description = "Python client for Appium"
-version = "6.0.7"
+version = "6.0.9"
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE"]
@@ -22,12 +22,13 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Environment :: Console",
     "Topic :: Software Development :: Testing",
 ]
 requires-python = ">=3.10"
 dependencies = [
-  "selenium>=4.37.0,<5.0",
+  "selenium>=4.51.0,<5.0",
   "typing-extensions~=4.16",
 ]
 
@@ -41,17 +42,17 @@ Changelog = "https://github.com/appium/python-client/blob/master/CHANGELOG.md"
 dev = [
   "httpretty~=1.1",
   "mock~=5.2",
-  "mypy>=1.17,<3.0",
+  "mypy>=2.4,<3.0",
   "pre-commit~=4.6",
-  "pytest>=8.4,<10.0",
-  "pytest-cov>=6.2,<8.0",
+  "pytest>=9.1,<10.0",
+  "pytest-cov>=7.1,<8.0",
   "pytest-xdist~=3.8",
   "python-dateutil~=2.9",
-  "ruff~=0.16",
+  "ruff~=0.17",
   "types-python-dateutil~=2.9",
 
   # for release
-  "python-semantic-release>=10.3.1,<10.7.0",
+  "python-semantic-release>=10.7.0,<10.8.0",
 
   # for documentation
   "sphinx>=4.0,<9.0",