AltTester-Driver 2.3.2__tar.gz → 2.4.0__tar.gz

{alttester_driver-2.3.2 → alttester_driver-2.4.0}/AltTester_Driver.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AltTester-Driver
-Version: 2.3.2
+Version: 2.4.0
 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
@@ -9,6 +9,7 @@ License: Proprietary
 Project-URL: Bug Tracker, https://github.com/alttester/AltTester-Unity-SDK/issues
 Project-URL: Documentation, https://alttester.com/docs/sdk/latest
 Project-URL: Source, https://github.com/alttester/AltTester-Unity-SDK
+Project-URL: License, https://alttester.com/app/uploads/AltTester/sdks/alttester/LICENSE
 Keywords: unity testing tests
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -34,7 +35,6 @@ 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,7 +47,6 @@ 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.2 → alttester_driver-2.4.0}/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.2 → alttester_driver-2.4.0}/LICENSE

@@ -15,8 +15,8 @@ The Software Product is owned exclusively by Licensor and is proprietary in natu
 (b) deliver a copy of the Software Product to a single client as part of a proof-of-concept or reference implementation, provided that (i) Licensee ensures that the client holds, or will obtain, a valid AltTester® software subscription covering their use of the Software Product; (ii) the Software Product is delivered unmodified; and (iii) the delivery is not made through any public channel described in §3.2(c).
 (c) integrate the Software Product into your own internal software tools or test automation pipelines. Any distribution, bundling, or making available of such integration to third parties outside the scope of Section 3.1(a) or Section 3.1(b) requires the prior written consent of Licensor.
 3.2 You may not:
-(a) use the Software Product without a valid AltTester® software subscription — Community,
-Pro or Enterprise — obtained from Licensor;
+(a) use the Software Product without a valid AltTester® software subscription — Lite or
+Pro — obtained from Licensor;
 (b) sublicense, rent, lease, give or transfer any rights in the Software Product or
 accompanying documentation in any form to any person or entity without the prior written
 consent of Licensor;
@@ -39,7 +39,7 @@ termination of this License and will make available to Licensor any and all othe
 whether in law or in equity.
 4. Term of License
 This License will be effective from the date you obtain a valid AltTester® software subscription
-(Community, Pro, or Enterprise) from Licensor and shall remain in force until (a) the expiration
+(Lite or Pro) from Licensor and shall remain in force until (a) the expiration
 or termination of your AltTester® software subscription; or (b) Licensor otherwise terminates this
 agreement, whichever is earlier. Upon termination you agree to destroy all copies of the
 Software Product and its documentation including any Software Products stored on the hard

{alttester_driver-2.3.2 → alttester_driver-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AltTester-Driver
-Version: 2.3.2
+Version: 2.4.0
 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
@@ -9,6 +9,7 @@ License: Proprietary
 Project-URL: Bug Tracker, https://github.com/alttester/AltTester-Unity-SDK/issues
 Project-URL: Documentation, https://alttester.com/docs/sdk/latest
 Project-URL: Source, https://github.com/alttester/AltTester-Unity-SDK
+Project-URL: License, https://alttester.com/app/uploads/AltTester/sdks/alttester/LICENSE
 Keywords: unity testing tests
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -34,7 +35,6 @@ 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,7 +47,6 @@ 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.2 → alttester_driver-2.4.0}/alttester/__version__.py

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

{alttester_driver-2.3.2 → alttester_driver-2.4.0}/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.2 → alttester_driver-2.4.0}/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,7 +86,7 @@ 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

{alttester_driver-2.3.2 → alttester_driver-2.4.0}/setup.py

@@ -41,6 +41,7 @@ setup(
         "Bug Tracker": "https://github.com/alttester/AltTester-Unity-SDK/issues",
         "Documentation": "https://alttester.com/docs/sdk/latest",
         "Source": "https://github.com/alttester/AltTester-Unity-SDK",
+        "License": "https://alttester.com/app/uploads/AltTester/sdks/alttester/LICENSE",
     },
 
     author=AUTHOR,
@@ -52,6 +53,7 @@ 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.0/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.0/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.2 → alttester_driver-2.4.0}/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.2 → alttester_driver-2.4.0}/tests/integration/test_driver.py

@@ -8,8 +8,6 @@ import pytest
 
 from .utils import Scenes
 from alttester import By
-from alttester.__version__ import VERSION
-from alttester.commands import GetServerVersion
 from alttester.logging import AltLogLevel, AltLogger
 import alttester.exceptions as exceptions
 
@@ -93,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"],
@@ -104,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.2 → alttester_driver-2.4.0}/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.0/tests/unit/__init__.py

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

{alttester_driver-2.3.2 → alttester_driver-2.4.0}/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()