AltTester-Driver 2.3.3__tar.gz → 2.4.1__tar.gz

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/AltTester_Driver.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AltTester-Driver
-Version: 2.3.3
+Version: 2.4.1
 Summary: Python bindings for the AltTester® framework. AltTester® is an UI driven test automation tool that helps you find objects in your game and interacts with them.
 Home-page: https://alttester.com/docs/sdk/latest/
 Author: Altom Consulting
@@ -35,6 +35,7 @@ Classifier: Topic :: Software Development :: Testing :: Acceptance
 Classifier: Topic :: Software Development :: Testing :: Unit
 Requires-Python: >=3.4.0
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: loguru
 Requires-Dist: deprecated
 Requires-Dist: websocket-client
@@ -47,6 +48,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/AltTester_Driver.egg-info/SOURCES.txt

@@ -90,6 +90,9 @@ alttester/commands/UnityCommands/set_player_pref_key.py
 alttester/commands/UnityCommands/set_time_scale.py
 alttester/commands/UnityCommands/unload_scene.py
 alttester/commands/UnityCommands/wait_for_current_scene_to_be.py
+tests/appium/__init__.py
+tests/appium/conftest.py
+tests/appium/test_native_popup.py
 tests/integration/__init__.py
 tests/integration/conftest.py
 tests/integration/test_driver.py

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AltTester-Driver
-Version: 2.3.3
+Version: 2.4.1
 Summary: Python bindings for the AltTester® framework. AltTester® is an UI driven test automation tool that helps you find objects in your game and interacts with them.
 Home-page: https://alttester.com/docs/sdk/latest/
 Author: Altom Consulting
@@ -35,6 +35,7 @@ Classifier: Topic :: Software Development :: Testing :: Acceptance
 Classifier: Topic :: Software Development :: Testing :: Unit
 Requires-Python: >=3.4.0
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: loguru
 Requires-Dist: deprecated
 Requires-Dist: websocket-client
@@ -47,6 +48,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/alttester/__version__.py

@@ -2,4 +2,4 @@
     Copyright(C) 2026 Altom Consulting
 """
 
-VERSION = "2.3.3"
+VERSION = "2.4.1"

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/alttester/_websocket.py

@@ -84,8 +84,8 @@ class NotificationHandler:
     def add_notification_listener(self, notification_type, callback, overwrite=False):
         if overwrite:
             self._notification_callbacks[notification_type] = [callback]
-
-        self._notification_callbacks[notification_type].append(callback)
+        else:
+            self._notification_callbacks[notification_type].append(callback)
 
     def remove_notification_listener(self, notification_type):
         self._notification_callbacks[notification_type].clear()

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/alttester/altdriver.py

@@ -33,6 +33,7 @@ class AltDriver:
         enable_logging (:obj:`bool`, optional): If set to ``True`` will turn on logging, by default logging is disabled.
         timeout (:obj:`int`, :obj:`float`, optional): The timeout duration for establishing a connection, in seconds.
             If set to ``None``, the connection attempt will wait indefinitely. The default value is ``60`` seconds.
+        driver_type (:obj:`str`, optional): The driver type reported to the AltTester® Server. Defaults to ``python``.
 
     """
 
@@ -47,7 +48,8 @@ class AltDriver:
         platform_version="unknown",
         device_instance_id="unknown",
         app_id="unknown",
-        secure_mode=False
+        secure_mode=False,
+        driver_type="python"
     ):
         self.host = host
         self.port = port
@@ -59,6 +61,7 @@ class AltDriver:
         self.device_instance_id = device_instance_id
         self.app_id = app_id
         self.secure_mode = secure_mode
+        self.driver_type = driver_type
 
         self._config_logging(self.enable_logging)
 
@@ -83,13 +86,23 @@ class AltDriver:
                 "platformVersion": self.platform_version,
                 "deviceInstanceId": self.device_instance_id,
                 "appId": self.app_id,
-                "driverType": "python_" + VERSION
+                "driverType": self.driver_type + "_" + VERSION
             },
             command_handler=self._command_handler,
             notification_handler=self._notification_handler
         )
-        self._connection.connect()
-        self._check_server_version()
+        try:
+            self._connection.connect()
+            self._check_server_version()
+        except BaseException:
+            self._close_after_failed_connect()
+            raise
+
+    def _close_after_failed_connect(self):
+        try:
+            self._connection.close()
+        except Exception as ex:
+            logger.debug("Failed to close the connection after a failed connect: {}", ex)
 
     def __repr__(self):
         return "{}({!r}, {!r}, {!r}, {!r}, {!r})".format(

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/setup.py

@@ -53,7 +53,6 @@ setup(
     install_requires=REQUIRED,
     packages=find_packages(exclude=['tests']),
     include_package_data=True,
-    license_files=[],
 
     classifiers=[
         "Development Status :: 5 - Production/Stable",

alttester_driver-2.4.1/tests/appium/conftest.py

@@ -0,0 +1,113 @@
+"""
+    Copyright(C) 2026 Altom Consulting
+"""
+
+import datetime
+import os
+import time
+import pytest
+from appium import webdriver
+from appium.options.android import UiAutomator2Options
+from appium.options.ios import XCUITestOptions
+
+
+saucelabs_devices = [
+    {"name": "Samsung Galaxy S23.*", "os": "android", "os_version": "13"},
+    {"name": "Samsung Galaxy S22.*", "os": "android", "os_version": "12"},
+    {"name": "iPhone 16.*", "os": "ios", "os_version": "18"},
+    {"name": "iPhone 15.*", "os": "ios", "os_version": "17"},
+    {"name": "iPhone 14.*", "os": "ios", "os_version": "16"},
+    {"name": "OnePlus 9.*", "os": "android", "os_version": "11"},
+]
+
+saucelabs_android_devices = [d for d in saucelabs_devices if d["os"] == "android"]
+saucelabs_ios_devices = [d for d in saucelabs_devices if d["os"] == "ios"]
+
+
+def get_saucelabs_username():
+    return os.environ.get("SAUCE_USERNAME", "")
+
+
+def get_saucelabs_access_key():
+    return os.environ.get("SAUCE_ACCESS_KEY", "")
+
+
+def get_saucelabs_region():
+    return os.environ.get("SAUCE_REGION", "us-west-1")
+
+
+def get_saucelabs_tunnel_name():
+    return os.environ.get("SAUCE_TUNNEL_NAME", "alttester-tunnel")
+
+
+def get_saucelabs_app_url(device):
+    if device["os"] == "android":
+        return os.environ.get("SAUCE_APP_URL_ANDROID", "")
+    return os.environ.get("SAUCE_APP_URL_IOS", "")
+
+
+def get_saucelabs_capabilities(device):
+    return {
+        "platformName": "Android" if device["os"] == "android" else "iOS",
+        "appium:deviceName": device["name"],
+        "appium:platformVersion": device["os_version"],
+        "appium:app": get_saucelabs_app_url(device),
+        "appium:automationName": "UiAutomator2" if device["os"] == "android" else "XCUITest",
+        "appium:newCommandTimeout": 2000,
+        "sauce:options": {
+            "username": get_saucelabs_username(),
+            "accessKey": get_saucelabs_access_key(),
+            "build": "AltTester SDK - Native Popup",
+            "name": "native-popup-{date:%Y-%m-%d_%H:%M:%S}".format(date=datetime.datetime.now()),
+            "tunnelName": get_saucelabs_tunnel_name(),
+            "tunnelOwner": get_saucelabs_username(),
+            "appiumVersion": "latest",
+            "idleTimeout": 300,
+        }
+    }
+
+
+def create_appium_driver(device):
+    caps = get_saucelabs_capabilities(device)
+    region = get_saucelabs_region()
+    hub_url = "https://ondemand.{}.saucelabs.com:443/wd/hub".format(region)
+    if device["os"] == "android":
+        options = UiAutomator2Options().load_capabilities(caps)
+    else:
+        options = XCUITestOptions().load_capabilities(caps)
+    driver = webdriver.Remote(hub_url, options=options)
+    time.sleep(10)
+    return driver
+
+
+@pytest.fixture(autouse=True, scope="session")
+def worker_id(request):
+    request.config.getoption("--dist", default="no", skip=True)
+    if hasattr(request.config, "workerinput"):
+        return request.config.workerinput["workerid"]
+    return "master"
+
+
+@pytest.fixture(autouse=True, scope="session")
+def current_device(worker_id):
+    if os.environ.get("RUN_IN_SAUCELABS_ANDROID_ONLY", "") == "true":
+        selected_devices = saucelabs_android_devices
+    elif os.environ.get("RUN_IN_SAUCELABS_IOS_ONLY", "") == "true":
+        selected_devices = saucelabs_ios_devices
+    else:
+        selected_devices = saucelabs_devices
+
+    if worker_id == "master":
+        return selected_devices[0]
+    index = int(worker_id.split("gw")[1])
+    return selected_devices[index % len(selected_devices)]
+
+
+@pytest.fixture(scope="class")
+def appium_driver(current_device):
+    driver = create_appium_driver(current_device)
+    yield driver
+    try:
+        driver.quit()
+    except Exception:
+        pass

alttester_driver-2.4.1/tests/appium/test_native_popup.py

@@ -0,0 +1,106 @@
+"""
+    Copyright(C) 2026 Altom Consulting
+
+    Tests that verify the AltTester native connection settings popup appears
+    and can be interacted with via Appium on iOS and Android.
+"""
+
+import pytest
+from appium.webdriver.common.appiumby import AppiumBy
+
+
+POPUP_ELEMENTS = [
+    "AltTesterHostInputField",
+    "AltTesterPortInputField",
+    "AltTesterAppNameInputField",
+    "AltTesterDontShowAgainCheckbox",
+    "AltTesterOkButton",
+]
+
+HOST_PLACEHOLDER = "Host"
+PORT_PLACEHOLDER = "Port"
+APP_NAME_PLACEHOLDER = "App Name"
+IMPLICIT_WAIT_TIMEOUT = 60
+
+
+class TestNativePopup:
+
+    @pytest.fixture(autouse=True)
+    def setup(self, appium_driver, current_device):
+        self.driver = appium_driver
+        self.device = current_device
+        self.driver.implicitly_wait(IMPLICIT_WAIT_TIMEOUT)
+
+    def _find(self, accessibility_id):
+        return self.driver.find_element(
+            by=AppiumBy.ACCESSIBILITY_ID, value=accessibility_id
+        )
+
+    def test_popup_appears_on_launch(self):
+        """Verify the connection settings popup is displayed when the app launches."""
+        for element_id in POPUP_ELEMENTS:
+            element = self._find(element_id)
+            assert element.is_displayed(), \
+                "Expected '{}' to be visible but it was not".format(element_id)
+
+    def test_popup_host_field_starts_empty(self):
+        """Verify the host input field starts empty, showing its placeholder text."""
+        host_field = self._find("AltTesterHostInputField")
+        assert host_field.text == HOST_PLACEHOLDER, \
+            "Expected placeholder '{}', got '{}'".format(HOST_PLACEHOLDER, host_field.text)
+
+    def test_popup_port_field_starts_empty(self):
+        """Verify the port input field starts empty, showing its placeholder text."""
+        port_field = self._find("AltTesterPortInputField")
+        assert port_field.text == PORT_PLACEHOLDER, \
+            "Expected placeholder '{}', got '{}'".format(PORT_PLACEHOLDER, port_field.text)
+
+    def test_popup_app_name_field_starts_empty(self):
+        """Verify the app name input field starts empty, showing its placeholder text."""
+        app_name_field = self._find("AltTesterAppNameInputField")
+        assert app_name_field.text == APP_NAME_PLACEHOLDER, \
+            "Expected placeholder '{}', got '{}'".format(APP_NAME_PLACEHOLDER, app_name_field.text)
+
+    def test_popup_fields_are_editable(self):
+        """Verify host, port, and app name fields accept user input."""
+        host_field = self._find("AltTesterHostInputField")
+        host_field.clear()
+        host_field.send_keys("192.168.1.1")
+        assert host_field.text == "192.168.1.1"
+
+        port_field = self._find("AltTesterPortInputField")
+        port_field.clear()
+        port_field.send_keys("13001")
+        assert port_field.text == "13001"
+
+        app_name_field = self._find("AltTesterAppNameInputField")
+        app_name_field.clear()
+        app_name_field.send_keys("MyApp")
+        assert app_name_field.text == "MyApp"
+
+    def _is_checked(self):
+        # Android exposes "selected" and "checked" as distinct accessibility
+        # properties; a CheckBox only ever updates "checked" on toggle, so
+        # is_selected() (which reads "selected") never reflects its state.
+        return self._find("AltTesterDontShowAgainCheckbox").get_attribute("checked") == "true"
+
+    def test_dont_show_again_checkbox_is_toggleable(self):
+        """Verify the 'Don't show this again' checkbox can be toggled."""
+        initial_state = self._is_checked()
+        self._find("AltTesterDontShowAgainCheckbox").click()
+        assert self._is_checked() != initial_state, \
+            "Checkbox state did not change after click"
+        # restore
+        self._find("AltTesterDontShowAgainCheckbox").click()
+        assert self._is_checked() == initial_state
+
+    def test_popup_dismisses_on_ok(self):
+        """Verify the popup disappears after tapping OK."""
+        ok_button = self._find("AltTesterOkButton")
+        ok_button.click()
+
+        self.driver.implicitly_wait(5)
+        elements = self.driver.find_elements(
+            by=AppiumBy.ACCESSIBILITY_ID, value="AltTesterOkButton"
+        )
+        assert len(elements) == 0, "Popup was still visible after tapping OK"

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/tests/integration/conftest.py

@@ -76,6 +76,10 @@ def get_app_name():
     return os.environ.get("ALTSERVER_APP_NAME", "__default__")
 
 
+def get_platform_version():
+    return os.environ.get("ALTSERVER_PLATFORM_VERSION", "unknown")
+
+
 def get_browserstack_username():
     return os.environ.get("BROWSERSTACK_USERNAME", "")
 
@@ -143,7 +147,9 @@ def alt_driver(request, appium_driver, worker_id, current_device):
         port=get_port(),
         app_name=get_app_name(),
         platform=platform,
-        platform_version=current_device["os_version"].split(".")[0],
+        platform_version=get_platform_version()
+        if current_device["os_version"] == "unknown"
+        else current_device["os_version"].split(".")[0],
         timeout=180
     )
     if alt_driver is None:
@@ -189,13 +195,6 @@ def log_to_report(message):
 
 @pytest.fixture(autouse=True, scope="session")
 def current_device(request, worker_id):
-    global devices
-    global local_run_device
-    global android_devices
-    global ios_devices
-    global saucelabs_devices
-    global saucelabs_android_devices
-    global saucelabs_ios_devices
     current_device = None
     selected_devices = []
     if os.environ.get("RUN_IN_SAUCELABS", "") == "true":

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/tests/integration/test_driver.py

@@ -91,7 +91,7 @@ class TestDriver:
     @pytest.mark.WebGLUnsupported
     def test_set_server_logging(self):
         rule = self.alt_driver.call_static_method(
-            "AltTester.AltTesterUnitySDK.Logging.ServerLogManager",
+            "AltTester.AltTesterUnitySDK.Logging.AltTesterLogManager",
             "Instance.Configuration.FindRuleByName",
             "Assembly-CSharp",
             parameters=["AltServerFileRule"],
@@ -102,7 +102,7 @@ class TestDriver:
 
         self.alt_driver.set_server_logging(AltLogger.File, AltLogLevel.Off)
         rule = self.alt_driver.call_static_method(
-            "AltTester.AltTesterUnitySDK.Logging.ServerLogManager",
+            "AltTester.AltTesterUnitySDK.Logging.AltTesterLogManager",
             "Instance.Configuration.FindRuleByName",
             "Assembly-CSharp",
             parameters=["AltServerFileRule"],

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/tests/integration/test_scene01_part2.py

@@ -401,6 +401,7 @@ class TestScene01Part2:
         assert type(plane.worldY) is float
         assert type(plane.worldZ) is float
 
+    @pytest.mark.skip(reason="Flaky: tilt's server-side duration isn't reliably honored in CI")
     def test_set_command_response_timeout(self):
         self.alt_driver.set_command_response_timeout(1)
         with pytest.raises(exceptions.CommandResponseTimeoutException) as execinfo:

alttester_driver-2.4.1/tests/unit/__init__.py

@@ -0,0 +1,3 @@
+"""
+    Copyright(C) 2026 Altom Consulting
+"""

{alttester_driver-2.3.3 → alttester_driver-2.4.1}/tests/unit/test_websocket.py

@@ -9,6 +9,7 @@ import pytest
 
 from alttester._websocket import Store, WebsocketConnection, CommandHandler, NotificationHandler
 from alttester.exceptions import ConnectionError
+from alttester.commands.Notifications.notification_type import NotificationType
 
 
 class TestStore:
@@ -182,3 +183,50 @@ class TestWebsocketConnection:
 
         assert self.connection._command_handler.get_current_command() != (
             command["messageId"], command["commandName"])
+
+
+class TestNotificationHandler:
+
+    @pytest.fixture(autouse=True)
+    def setup(self):
+        self.notification_handler = NotificationHandler()
+        self.paused_message = {
+            "commandName": "applicationPausedNotification",
+            "data": json.dumps(True)
+        }
+
+    def test_add_notification_listener_with_overwrite(self):
+        first_callback = mock.Mock()
+        second_callback = mock.Mock()
+
+        self.notification_handler.add_notification_listener(
+            NotificationType.APPLICATION_PAUSED, first_callback, overwrite=True)
+        self.notification_handler.add_notification_listener(
+            NotificationType.APPLICATION_PAUSED, second_callback, overwrite=True)
+        self.notification_handler.handle_notification(self.paused_message)
+
+        first_callback.assert_not_called()
+        second_callback.assert_called_once_with(True)
+
+    def test_add_notification_listener_without_overwrite(self):
+        first_callback = mock.Mock()
+        second_callback = mock.Mock()
+
+        self.notification_handler.add_notification_listener(
+            NotificationType.APPLICATION_PAUSED, first_callback, overwrite=False)
+        self.notification_handler.add_notification_listener(
+            NotificationType.APPLICATION_PAUSED, second_callback, overwrite=False)
+        self.notification_handler.handle_notification(self.paused_message)
+
+        first_callback.assert_called_once_with(True)
+        second_callback.assert_called_once_with(True)
+
+    def test_remove_notification_listener(self):
+        callback = mock.Mock()
+
+        self.notification_handler.add_notification_listener(
+            NotificationType.APPLICATION_PAUSED, callback, overwrite=True)
+        self.notification_handler.remove_notification_listener(NotificationType.APPLICATION_PAUSED)
+        self.notification_handler.handle_notification(self.paused_message)
+
+        callback.assert_not_called()