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

{appium_python_client-6.0.5 → appium_python_client-6.0.7}/.github/actions/setup-appium-server/action.yml

@@ -28,6 +28,8 @@ runs:
   steps:
     - name: Start Appium server
       shell: bash
+      env:
+        LOG_FILE: ${{ inputs.log_file }}
       run: |
         nohup appium server \
           --port=${{ inputs.port }} \
@@ -36,10 +38,12 @@ runs:
           --log-timestamp \
           --keep-alive-timeout 1200 \
           ${{ inputs.server_args }} \
-          2>&1 > ${{ inputs.log_file }} &
+          > "$LOG_FILE" 2>&1 &
 
     - name: Wait for Appium server to start
       shell: bash
+      env:
+        LOG_FILE: ${{ inputs.log_file }}
       run: |
         TIMEOUT_SEC=${{ inputs.timeout }}
         INTERVAL_SEC=1
@@ -51,12 +55,13 @@ runs:
 
           if nc -z ${{ inputs.host }} ${{ inputs.port }}; then
             echo "Appium server is running after $elapsed seconds"
-            cat ${{ inputs.log_file }}
+            cat "$LOG_FILE"
             exit 0
           fi
 
           if [[ "$elapsed" -ge "$TIMEOUT_SEC" ]]; then
             echo "${elapsed} seconds timeout reached: Appium server is NOT running"
+            cat "$LOG_FILE"
             exit 1
           fi
 

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

@@ -14,9 +14,11 @@ env:
   APPIUM_TEST_SERVER_PORT: '4723'
   APPIUM_TEST_SERVER_HOST: '127.0.0.1'
   PYTHONUNBUFFERED: 1
+  UV_LOCKED: 'true'
 
 jobs:
   ios_test:
+    timeout-minutes: 60
     strategy:
       fail-fast: false
       matrix:
@@ -80,39 +82,37 @@ jobs:
       with:
         python-version: 3.14
 
-    - name: Cache uv modules
-      uses: actions/cache@v6
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v10.1.0
       with:
-        path: |
-          ~/.cache/uv
-          .venv
-        key: ${{ runner.os }}-uv-shared-${{ hashFiles('**/uv.lock') }}
-        restore-keys: |
-          ${{ runner.os }}-uv-shared-
-
-    - name: Install uv
-      run: make install-uv
+        enable-cache: true
+        python-version: '3.14'
 
     - name: Run Tests
       run: |
         uv run pytest -v ${{ matrix.test_targets.target}} \
           --doctest-modules \
           --junitxml=junit/test-results.xml \
-          --cov=com \
+          --cov=appium \
           --cov-report=xml \
           --cov-report=html
       env:
         LOCAL_PREBUILT_WDA: ${{ env.PREBUILT_WDA_PATH }}
 
-    - name: Save server output
+    - name: Save test diagnostics
       if: ${{ always() }}
       uses: actions/upload-artifact@master
       with:
-        name: appium-ios-${{matrix.test_targets.name}}.log
-        path: appium.log
+        name: appium-ios-${{matrix.test_targets.name}}-diagnostics
+        path: |
+          appium.log
+          junit/
+          coverage.xml
+          htmlcov/
 
 
   android_test:
+    timeout-minutes: 60
     strategy:
       fail-fast: false
       matrix:
@@ -129,7 +129,7 @@ jobs:
     steps:
     - uses: actions/checkout@v7
 
-    - uses: actions/setup-java@v6.0.0
+    - uses: actions/setup-java@v6.0.1
       with:
         distribution: 'temurin'
         java-version: '17'
@@ -189,15 +189,11 @@ jobs:
       with:
         python-version: 3.14
 
-    - name: Cache uv modules
-      uses: actions/cache@v6
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v10.1.0
       with:
-        path: |
-          ~/.cache/uv
-          .venv
-        key: ${{ runner.os }}-uv-shared-${{ hashFiles('**/uv.lock') }}
-        restore-keys: |
-          ${{ runner.os }}-uv-shared-
+        enable-cache: true
+        python-version: '3.14'
 
     - name: Run tests
       uses: reactivecircus/android-emulator-runner@v2
@@ -205,8 +201,7 @@ jobs:
         api-level: ${{ env.API_LEVEL }}
         arch: ${{ env.ARCH }}
         script: |
-          make install-uv
-          uv run pytest -v ${{ matrix.test_targets.target}} --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
+          uv run pytest -v ${{ matrix.test_targets.target}} --doctest-modules --junitxml=junit/test-results.xml --cov=appium --cov-report=xml --cov-report=html
         target: google_apis
         profile: Nexus 5X
         disable-spellchecker: true
@@ -218,14 +213,19 @@ jobs:
         IGNORE_VERSION_SKIP: true
         CI: true
 
-    - name: Save server output
+    - name: Save test diagnostics
       if: ${{ always() }}
       uses: actions/upload-artifact@master
       with:
-        name: appium-android-${{matrix.test_targets.name}}.log
-        path: appium.log
+        name: appium-android-${{matrix.test_targets.name}}-diagnostics
+        path: |
+          appium.log
+          junit/
+          coverage.xml
+          htmlcov/
 
   flutter_e2e_test:
+    timeout-minutes: 60
     # These flutter integration driver tests are maintained by: MummanaSubramanya
     strategy:
       fail-fast: false
@@ -253,7 +253,7 @@ jobs:
 
     - uses: actions/checkout@v7
 
-    - uses: actions/setup-java@v6.0.0
+    - uses: actions/setup-java@v6.0.1
       if: matrix.e2e-tests == 'flutter-android'
       with:
         distribution: 'zulu'
@@ -305,15 +305,11 @@ jobs:
         server_args: '--relaxed-security'
         log_file: appium-${{ matrix.e2e-tests }}.log
 
-    - name: Cache uv modules
-      uses: actions/cache@v6
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v10.1.0
       with:
-        path: |
-          ~/.cache/uv
-          .venv
-        key: ${{ runner.os }}-uv-shared-${{ hashFiles('**/uv.lock') }}
-        restore-keys: |
-          ${{ runner.os }}-uv-shared-
+        enable-cache: true
+        python-version: '3.14'
 
     - name: Run Android tests
       if: matrix.e2e-tests == 'flutter-android'
@@ -321,8 +317,7 @@ jobs:
       with:
         api-level: ${{ env.API_LEVEL }}
         script: |
-          make install-uv
-          uv run pytest -v test/functional/flutter_integration/*_test.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
+          uv run pytest -v test/functional/flutter_integration/*_test.py --doctest-modules --junitxml=junit/test-results.xml --cov=appium --cov-report=xml --cov-report=html
         target: default
         disable-spellchecker: true
         disable-animations: true
@@ -349,20 +344,23 @@ jobs:
     - name: Run IOS tests
       if: matrix.e2e-tests == 'flutter-ios'
       run: |
-        make install-uv
         export PLATFORM=ios
         uv run pytest -v test/functional/flutter_integration/*_test.py \
           --doctest-modules \
           --junitxml=junit/test-results.xml \
-          --cov=com \
+          --cov=appium \
           --cov-report=xml \
           --cov-report=html
       env:
         LOCAL_PREBUILT_WDA: ${{ env.PREBUILT_WDA_PATH }}
 
-    - name: Save server output
+    - name: Save test diagnostics
       if: ${{ always() }}
       uses: actions/upload-artifact@master
       with:
-        name: appium-${{ matrix.e2e-tests }}.log
-        path: appium-${{ matrix.e2e-tests }}.log
+        name: appium-${{ matrix.e2e-tests }}-diagnostics
+        path: |
+          appium-${{ matrix.e2e-tests }}.log
+          junit/
+          coverage.xml
+          htmlcov/

appium_python_client-6.0.7/.github/workflows/unit-test.yml

@@ -0,0 +1,57 @@
+name: Unit tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+env:
+  UV_LOCKED: 'true'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+    - uses: actions/checkout@v7
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: '3.14'
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v10.1.0
+      with:
+        enable-cache: true
+        python-version: '3.14'
+    - name: Check lint and formatting
+      run: |
+        uv run ruff check .
+        make check-format
+
+  test-ubuntu:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+    - uses: actions/checkout@v7
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v10.1.0
+      with:
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
+    - name: Check types
+      run: uv run mypy appium
+    - name: Run Unit Tests
+      run: make unittest

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

@@ -2,6 +2,69 @@
 
 <!-- version list -->
 
+## v6.0.7 (2026-09-18)
+
+### Bug Fixes
+
+- **webdriver**: Normalize orientation value to uppercase in setter
+  ([#1308](https://github.com/appium/python-client/pull/1308),
+  [`1162bab`](https://github.com/appium/python-client/commit/1162bab613a3418b6f9b4d2cdb5e41dfebd28ede))
+
+### Continuous Integration
+
+- Enhance ci env ([#1303](https://github.com/appium/python-client/pull/1303),
+  [`e7acbb2`](https://github.com/appium/python-client/commit/e7acbb2362cd07ec142c85264ca59a442778acf1))
+
+### Refactoring
+
+- **webdriver**: Simplify direct connect capabilities check and logging
+  ([#1302](https://github.com/appium/python-client/pull/1302),
+  [`e23dc47`](https://github.com/appium/python-client/commit/e23dc47f0cd8e895fd558a0beae72cdcba8ef68e))
+
+### Testing
+
+- Add orientation getter and setter unit tests
+  ([#1307](https://github.com/appium/python-client/pull/1307),
+  [`90c38d1`](https://github.com/appium/python-client/commit/90c38d1640d75f0c0911c9a31ddc98ff1baa9ab1))
+
+- Add unit tests for orientation setter ([#1289](https://github.com/appium/python-client/pull/1289),
+  [`ac77fcf`](https://github.com/appium/python-client/commit/ac77fcffa69d130fa5e4fe1b3969330884b14c6e))
+
+- Fix flutter app asset download url in ci
+  ([#1289](https://github.com/appium/python-client/pull/1289),
+  [`ac77fcf`](https://github.com/appium/python-client/commit/ac77fcffa69d130fa5e4fe1b3969330884b14c6e))
+
+- Fix timeouts in ios safari test ([#1289](https://github.com/appium/python-client/pull/1289),
+  [`ac77fcf`](https://github.com/appium/python-client/commit/ac77fcffa69d130fa5e4fe1b3969330884b14c6e))
+
+
+## v6.0.6 (2026-09-12)
+
+### Bug Fixes
+
+- Preserve capability alternatives from option lists
+  ([#1296](https://github.com/appium/python-client/pull/1296),
+  [`aa4492e`](https://github.com/appium/python-client/commit/aa4492ef25d8bee4b8ef763f088f7745d6a4d07e))
+
+### Continuous Integration
+
+- **deps**: Bump actions/setup-java from 6.0.0 to 6.0.1
+  ([#1301](https://github.com/appium/python-client/pull/1301),
+  [`d555d77`](https://github.com/appium/python-client/commit/d555d779a63a74d1c03d92a15daca31a5e2e4e79))
+
+### Documentation
+
+- Add 2026 year in copyright and actualization packageVersion
+  ([#1300](https://github.com/appium/python-client/pull/1300),
+  [`392dd39`](https://github.com/appium/python-client/commit/392dd3947453c99d2b62917cd09562d2f21d9d97))
+
+### Testing
+
+- Cover W3C alternatives from option lists
+  ([#1296](https://github.com/appium/python-client/pull/1296),
+  [`aa4492e`](https://github.com/appium/python-client/commit/aa4492ef25d8bee4b8ef763f088f7745d6a4d07e))
+
+
 ## v6.0.5 (2026-09-10)
 
 ### Bug Fixes

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Appium-Python-Client
-Version: 6.0.5
+Version: 6.0.7
 Summary: Python client for Appium
 Project-URL: Homepage, https://appium.io/
 Project-URL: Repository, https://github.com/appium/python-client

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

@@ -248,6 +248,12 @@ class WebDriver(
         options: AppiumOptions | list[AppiumOptions] | None = None,
         client_config: AppiumClientConfig | None = None,
     ):
+        if isinstance(options, list):
+            # Normalize before Selenium separates common and alternative capabilities.
+            options = [
+                AppiumOptions().load_capabilities(AppiumOptions.as_w3c(option.to_capabilities())['capabilities']['alwaysMatch'])
+                for option in options
+            ]
         command_executor, client_config = _get_remote_connection_and_client_config(
             command_executor=command_executor, client_config=client_config
         )
@@ -308,11 +314,10 @@ class WebDriver(
 
         if not self.caps:
             raise ValueError('Driver capabilities must be defined')
-        if not {direct_protocol, direct_host, direct_port, direct_path}.issubset(set(self.caps)):
-            message = 'Direct connect capabilities from server were:\n'
-            for key in [direct_protocol, direct_host, direct_port, direct_path]:
-                message += f"{key}: '{self.caps.get(key, '')}' "
-            logger.debug(message)
+        keys = (direct_protocol, direct_host, direct_port, direct_path)
+        if not set(keys).issubset(self.caps):
+            details = ' '.join(f"{key}: '{self.caps.get(key, '')}'" for key in keys)
+            logger.debug(f'Direct connect capabilities from server were:\n{details} ')
             return
 
         protocol = self.caps[direct_protocol]
@@ -352,7 +357,17 @@ class WebDriver(
         if not isinstance(capabilities, (dict, AppiumOptions)):
             raise InvalidArgumentException('Capabilities must be a dictionary or AppiumOptions instance')
 
-        w3c_caps = AppiumOptions.as_w3c(capabilities) if isinstance(capabilities, dict) else capabilities.to_w3c()
+        if isinstance(capabilities, AppiumOptions):
+            w3c_caps = capabilities.to_w3c()
+        elif (
+            set(capabilities) == {'capabilities'}
+            and isinstance(capabilities['capabilities'], dict)
+            and {'alwaysMatch', 'firstMatch'}.issubset(capabilities['capabilities'])
+        ):
+            # Selenium already creates the W3C envelope when given a list of options.
+            w3c_caps = copy.deepcopy(capabilities)
+        else:
+            w3c_caps = AppiumOptions.as_w3c(capabilities)
         response = self.execute(RemoteCommand.NEW_SESSION, w3c_caps)
         # https://w3c.github.io/webdriver/#new-session
         if not isinstance(response, dict):
@@ -443,7 +458,7 @@ class WebDriver(
         """
         allowed_values = ['LANDSCAPE', 'PORTRAIT']
         if value.upper() in allowed_values:
-            self.execute(Command.SET_SCREEN_ORIENTATION, {'orientation': value})
+            self.execute(Command.SET_SCREEN_ORIENTATION, {'orientation': value.upper()})
         else:
             raise WebDriverException("You can only set the orientation to 'LANDSCAPE' and 'PORTRAIT'")
 

{appium_python_client-6.0.5 → appium_python_client-6.0.7}/docs/conf.py

@@ -18,12 +18,12 @@ sys.path.insert(0, os.path.abspath('../appium'))
 
 # -- Project information -----------------------------------------------------
 
-project = 'Python client 1.1'
-copyright = '2020-2025, Appium'
+project = 'Python client 6.0.5'
+copyright = '2020-2026, Appium'
 author = 'Appium'
 
 # The full version, including alpha/beta/rc tags
-release = '1.1'
+release = '6.0.5'
 
 language = 'en'
 

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

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

{appium_python_client-6.0.5 → appium_python_client-6.0.7}/uv.lock

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

appium_python_client-6.0.5/.github/workflows/lock-update.yml

@@ -1,31 +0,0 @@
-name: Update uv.lock
-
-on:
-  pull_request:
-    types: [ opened, synchronize ]
-    paths:
-      - 'pyproject.toml'
-
-permissions:
-  contents: write
-  pull-requests: write
-
-jobs:
-  uv-lock-update:
-    if: github.actor == 'dependabot[bot]'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v7
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          ref: ${{ github.head_ref }}
-      - name: Set up Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.12'
-      - name: Install uv
-        run: make install-uv
-      - run: uv lock
-      - uses: stefanzweifel/git-auto-commit-action@v7
-        with:
-          commit_message: "chore: Refresh uv.lock"

appium_python_client-6.0.5/.github/workflows/unit-test.yml

@@ -1,36 +0,0 @@
-name: Unit tests
-
-on:
-  workflow_dispatch:
-  push:
-    branches: [ master ]
-  pull_request:
-    branches: [ master ]
-
-jobs:
-  test-ubuntu:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
-    steps:
-    - uses: actions/checkout@v7
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v7
-      with:
-        python-version: ${{ matrix.python-version }}
-    - name: Cache uv modules
-      uses: actions/cache@v6
-      with:
-        path: |
-          ~/.cache/uv
-          .venv
-        key: ${{ runner.os }}-uv-shared-${{ hashFiles('**/uv.lock') }}
-        restore-keys: |
-          ${{ runner.os }}-uv-shared-
-    - name: Install uv
-      run: make install-uv
-    - name: Run Checks
-      run: make check
-    - name: Run Unit Tests
-      run: make unittest