AltTester-Driver 2.1.2__tar.gz → 2.2.0__tar.gz

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/AltTester_Driver.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: AltTester-Driver
-Version: 2.1.2
+Version: 2.2.0
 Summary: Python bindings for the AltTester® framework. AltTester® is an open-source 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

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/AltTester_Driver.egg-info/SOURCES.txt

@@ -81,6 +81,7 @@ alttester/commands/UnityCommands/get_all_loaded_scenes.py
 alttester/commands/UnityCommands/get_current_scene.py
 alttester/commands/UnityCommands/get_player_pref_key.py
 alttester/commands/UnityCommands/get_time_scale.py
+alttester/commands/UnityCommands/get_visual_element_property.py
 alttester/commands/UnityCommands/load_scene.py
 alttester/commands/UnityCommands/set_player_pref_key.py
 alttester/commands/UnityCommands/set_time_scale.py

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: AltTester-Driver
-Version: 2.1.2
+Version: 2.2.0
 Summary: Python bindings for the AltTester® framework. AltTester® is an open-source 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

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/alttester/__version__.py

@@ -15,4 +15,4 @@
     along with this program. If not, see <https://www.gnu.org/licenses/>.
 """
 
-VERSION = "2.1.2"
+VERSION = "2.2.0"

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/alttester/altdriver.py

@@ -133,18 +133,20 @@ class AltDriver:
 
     def _check_server_version(self):
         server_version = commands.GetServerVersion.run(self._connection)
-        logger.info(
-            "Connection established with instrumented Unity app. AltTester(R) Version: {}", server_version)
+        logger.info("Connection established with instrumented Unity app. AltTester(R) Version: {}".format(
+            server_version))
 
         major_server, minor_server = self._split_version(server_version)
-        major_driver, minor_driver = self._split_version(VERSION)
 
-        if major_server != major_driver or minor_server != minor_driver:
-            message = "Version mismatch. AltDriver version is {}. AltTester(R) version is {}.".format(
-                VERSION,
-                server_version
-            )
+        server_major = int(major_server)
+        server_minor = int(minor_server)
 
+        is_supported = (server_major == 2 and server_minor == 2) or (
+            server_major == 1 and server_minor == 0)
+
+        if not is_supported:
+            message = "Version mismatch. AltDriver version is {}. AltTester(R) version is {}.".format(
+                VERSION, server_version)
             logger.warning(message)
 
     def _get_alt_object(self, data):

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/alttester/altobject.py

@@ -18,6 +18,7 @@
 import json
 
 import alttester.commands as commands
+import alttester.exceptions as exceptions
 from alttester.by import By
 
 
@@ -368,3 +369,20 @@ class AltObject:
             self, count, interval, wait
         )
         return AltObject(self._altdriver, data)
+
+    def get_visual_element_property(self, property_name: str) -> str:
+        """Gets a value for a given visual element property.
+
+        Args:
+            property_name: The name of the property of which value you want to get.
+
+        Returns:
+            The property value is serialized to a JSON string.
+
+        Raises:
+            WrongAltObjectTypeException: The method is called on an object that is not a VisualElement.
+        """
+        if self.type != "UIToolkit":
+            raise exceptions.WrongAltObjectTypeException(
+                "This method is only available for VisualElement objects")
+        return commands.GetVisualElementProperty.run(self._connection,  property_name, self,)

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/alttester/commands/AltTesterCommands/add_notification_listener.py

@@ -22,7 +22,7 @@ from alttester.exceptions import InvalidParameterTypeException
 
 class AddNotificationListener(BaseCommand):
 
-    def __init__(self, connection, notification_type, notification_callback, overwrite):
+    def __init__(self, connection, notification_type, notification_callback, overwrite=False):
         super().__init__(connection, "activateNotification")
 
         if notification_type not in NotificationType:
@@ -33,7 +33,7 @@ class AddNotificationListener(BaseCommand):
             )
         self.notification_type = notification_type
 
-        if type(notification_callback) == "method":
+        if not callable(notification_callback):
             raise InvalidParameterTypeException(
                 parameter_name='notification_callback',
                 expected_types=[callable],
@@ -41,7 +41,7 @@ class AddNotificationListener(BaseCommand):
             )
         self.notification_callback = notification_callback
 
-        if type(overwrite) == "bool":
+        if not isinstance(overwrite, bool):
             raise InvalidParameterTypeException(
                 parameter_name='overwrite',
                 expected_types=[bool],

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/alttester/commands/UnityCommands/__init__.py

@@ -26,3 +26,4 @@ from alttester.commands.UnityCommands.set_time_scale import SetTimeScale
 from alttester.commands.UnityCommands.wait_for_current_scene_to_be import WaitForCurrentSceneToBe
 from alttester.commands.UnityCommands.get_all_loaded_scenes import GetAllLoadedScenes
 from alttester.commands.UnityCommands.unload_scene import UnloadScene
+from alttester.commands.UnityCommands.get_visual_element_property import GetVisualElementProperty

alttester_driver-2.2.0/alttester/commands/UnityCommands/get_visual_element_property.py

@@ -0,0 +1,40 @@
+"""
+    Copyright(C) 2024 Altom Consulting
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program. If not, see <https://www.gnu.org/licenses/>.
+"""
+
+from alttester.commands.base_command import BaseCommand
+
+
+class GetVisualElementProperty(BaseCommand):
+
+    def __init__(self, connection, property_name, alt_object):
+        super().__init__(connection, "getVisualElementProperty")
+
+        self.alt_object = alt_object
+        self.property_name = property_name
+
+    @property
+    def _parameters(self):
+        parameters = super()._parameters
+        parameters.update(**{
+            "altObject": self.alt_object.to_json(),
+            "property": self.property_name,
+        })
+
+        return parameters
+
+    def execute(self):
+        return self.send()

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/alttester/exceptions.py

@@ -159,3 +159,7 @@ class AltTesterInputModuleException(AltException):
 
 class UnknownErrorException(AltException):
     """Raised when an unexpected error occurred."""
+
+
+class WrongAltObjectTypeException(AltException):
+    """Raised when an object is not of the expected type."""

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/tests/integration/test_scene01_part1.py

@@ -137,7 +137,7 @@ class TestScene01Part1:
                 By.NAME, "EventNonExisting")
 
         assert str(
-            execinfo.value) == "Object //*[contains(@name,EventNonExisting)] not found"
+            execinfo.value) == "Object not found"
 
     def test_get_all_components(self):
         components = self.alt_driver.find_object(

{alttester_driver-2.1.2 → alttester_driver-2.2.0}/tests/integration/test_scene01_part2.py

@@ -407,9 +407,9 @@ class TestScene01Part2:
     def test_float_world_coordinates(self):
         plane = self.alt_driver.find_object(By.NAME, "Plane")
 
-        assert type(plane.worldX) == float
-        assert type(plane.worldY) == float
-        assert type(plane.worldZ) == float
+        assert type(plane.worldX) is float
+        assert type(plane.worldY) is float
+        assert type(plane.worldZ) is float
 
     def test_set_command_response_timeout(self):
         self.alt_driver.set_command_response_timeout(1)