fix: relax selenium exact pin to allow Appium 3 compatibility (#1312)

- Change `selenium==4.15.2` to `selenium>=4.15.2,<5.0.0` in packages/main
- Bump rpaframework version 31.1.2 -> 31.2.0
- Upgrade selenium in main's lock file: 4.15.2 -> 4.41.0
- Add standalone EdgeDriver integration test (packages/core) that exercises
  the azureedge.net -> microsoft.com redirect fix from PR #1227
- Add two pytest regression tests: API import check and constraint pin guard

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: mikahanninen

packages/core/tests/python/test_edge_driver.py

@@ -0,0 +1,88 @@
+#!/usr/bin/env python3
+"""Standalone EdgeDriver integration test for issue #1312.
+
+Verifies that:
+  1. EdgeDriver binary can be downloaded (tests azureedge.net -> microsoft.com
+     redirect fix from PR #1227) — this is the primary test
+  2. A headless Edge session can be started (end-to-end, requires Edge browser installed)
+
+Expected to FAIL with selenium==4.15.2 exact pin (old azureedge.net CDN issues).
+Expected to PASS after fix: selenium>=4.15.2,<5.0.0 (newer version resolved).
+
+Exit codes:
+    0 — download succeeded (session also started if Edge browser is installed)
+    1 — download or session failed unexpectedly
+
+Usage:
+    python test_edge_driver.py
+    # or from packages/core directory:
+    uv run python tests/python/test_edge_driver.py
+"""
+import shutil
+import sys
+from pathlib import Path
+
+
+def main() -> int:
+    import importlib.metadata
+
+    selenium_ver = importlib.metadata.version("selenium")
+    print(f"Selenium version: {selenium_ver}")
+
+    # Step 1: download EdgeDriver — exercises the azureedge.net redirect patch
+    try:
+        from RPA.core import webdriver
+
+        results_dir = Path(__file__).parent / "results"
+        results_dir.mkdir(exist_ok=True)
+        print("Downloading EdgeDriver...")
+        driver_path = webdriver.download("Edge", root=results_dir)
+        print(f"  Driver downloaded: {driver_path}")
+    except Exception as exc:
+        print(f"\nFAIL (download): {type(exc).__name__}: {exc}")
+        return 1
+
+    # Step 2: start a headless Edge session — requires Edge browser to be installed
+    edge_binary = shutil.which("msedge") or shutil.which("microsoft-edge")
+    if not edge_binary:
+        # Also check the standard macOS application path
+        macos_edge = Path("/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge")
+        if macos_edge.exists():
+            edge_binary = str(macos_edge)
+
+    if not edge_binary:
+        print(
+            "\nPASS (download only): EdgeDriver downloaded successfully. "
+            "Edge browser not installed — skipping session test."
+        )
+        return 0
+
+    try:
+        from selenium import webdriver as selenium_webdriver
+        from selenium.webdriver import EdgeOptions
+        from selenium.webdriver.edge.service import Service
+
+        options = EdgeOptions()
+        options.add_argument("--headless=new")
+        options.add_argument("--no-sandbox")
+        options.add_argument("--disable-dev-shm-usage")
+        options.binary_location = edge_binary
+        service = Service(driver_path)
+        print(f"Starting headless Edge session (binary: {edge_binary})...")
+        driver = selenium_webdriver.Edge(service=service, options=options)
+        try:
+            driver.get("about:blank")
+            title = driver.title
+        finally:
+            driver.quit()
+        print(f"  Session OK, page title: '{title}'")
+    except Exception as exc:
+        print(f"\nFAIL (session): {type(exc).__name__}: {exc}")
+        return 1
+
+    print("\nPASS: EdgeDriver download and session both work correctly.")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

packages/main/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rpaframework"
-version = "31.1.2"
+version = "31.2.0"
 description = "A collection of tools and libraries for RPA"
 authors = [{name = "RPA Framework", email = "rpafw@robocorp.com"}]
 license = {text = "Apache-2.0"}
@@ -60,7 +60,7 @@ dependencies = [
 	"mss>=6.0.0",
 	"chardet>=3.0.0",
 	"PySocks>=1.5.6,!=1.5.7,<2.0.0",
-	"selenium==4.15.2",
+	"selenium>=4.15.2,<5.0.0",
 	"click>=8.1.2",
 	"PyYAML>=5.4.1,<7.0.0",
 	"tenacity>=8.0.1",

packages/main/tests/python/test_browser.py

@@ -84,6 +84,47 @@ def test_custom_options(self, library):
         assert options_obj.binary_location == path
 
 
+def test_selenium_api_imports():
+    """All selenium APIs used by RPA.Browser.Selenium must remain importable.
+
+    Regression guard: if a newer selenium 4.x removes any of these, this test fails
+    before the constraint is widened further.
+    """
+    from selenium.common import WebDriverException  # noqa: F401
+    from selenium.common.exceptions import ElementClickInterceptedException  # noqa: F401
+    from selenium.webdriver import (  # noqa: F401
+        ChromeOptions,
+        EdgeOptions,
+        FirefoxOptions,
+        FirefoxProfile,
+        IeOptions,
+    )
+    from selenium.webdriver.common.by import By  # noqa: F401
+    from selenium.webdriver.common.options import ArgOptions  # noqa: F401
+    from selenium.webdriver.remote.shadowroot import ShadowRoot  # noqa: F401
+    from selenium.webdriver.support import expected_conditions  # noqa: F401
+    from selenium.webdriver.support.ui import WebDriverWait  # noqa: F401
+
+
+def test_selenium_constraint_is_not_exact_pin():
+    """Regression: selenium must not be pinned to an exact version (issue #1312).
+
+    An exact selenium==x.y.z pin blocks users from installing packages that require
+    a different selenium version (e.g. appium-python-client for Appium 3).
+    """
+    import re
+    from pathlib import Path
+
+    pyproject = (Path(__file__).parent.parent.parent / "pyproject.toml").read_text()
+    match = re.search(r'"selenium([^"]*)"', pyproject)
+    assert match, "selenium dependency not found in pyproject.toml"
+    constraint = match.group(1)
+    assert not constraint.startswith("=="), (
+        f"selenium must not be exact-pinned; got 'selenium{constraint}'. "
+        "Exact pins block Appium 3 and other selenium-dependent packages (issue #1312)."
+    )
+
+
 @pytest.mark.parametrize(
     "url,default,scheme",
     [