Package: coeus-test-unity
Coeus-UnityAboutCoeus-Unity is a collection of commands and assertions built oncoeus-testpackage for python. These commands support remote integration tests in Unity with the use of the C# Coeus test framework.Contributors@greg-morchower-aofl@leonidumanskiySetupSimply install the requirement into your package.pipinstallcoeus-test-unityCommandsCommands offer no response validation. You can use assertions for that.importcommandsresponse=commands.query_transform_exists(cli,"My/Transform Hierarchy/Object (Clone)")response=commands.query_scene_loaded(cli,"AppSetup")response=commands.query_renderer_visible(cli,"My/Target/Object (Clone)")response=commands.await_transform_exists(cli,"My/Transform Hierarchy/Object (Clone)")# Waits for renderer to become not visible based on False...response=commands.await_renderer_visible(cli,"My/Transform Hierarchy/Object (Clone)",False)response=commands.await_scene_loaded(cli,"AppSetup")# Finds a FieldInfo | PropertyInfo on the component and attempts to assign the value (String | Number | Boolean)commands.assign_component_value(cli,"My/Transform/Target","InputField","text","Hello World")# Finds a FieldInfo | PropertyInfo on the component and attempts to obtain its valuevalue=commands.fetch_component_value(cli,"My/Transform/Target","InputField","text")AssertionsSince commands only assert the response message, they don't verify the state being requested; for this we can use the assertions.importassertions# Fails immediately if transform doesn't exist...assertions.assert_transform_exists(cli,"Some/Path")# Fails immediately if scene not loaded...assertions.assert_scene_loaded(cli,"MyScene")# Awaits for the scene to be loaded, fails when exceeded...assertions.assert_await_scene_loaded(cli,"MyScene")# Awaits for a transform to exist by timeout, fails when exceeded...assertions.assert_await_transform_exists(cli,"Some/Path",timeout_seconds=10)# Awaits for a renderer to be visible by timeout, fails when exceeded...assertions.assert_await_renderer_visible(cli,"Some/Path",timeout_seconds=10)# Awaits for all transforms to exist by timeout, fails when exceeded...assertions.assert_await_all_transforms_exist(cli,["Some/Path1","Some/Path2"],timeout_seconds=10)# Awaits for any of the transforms to exist by timeout, fails when exceeded...assertions.assert_await_any_transforms_exist(cli,["Some/Path1","Some/Path2"],timeout_seconds=10)# Checks if FieldInfo | PropertyInfo on the component equals to the provided valueassertions.assert_component_value_equals(cli,"My/Transform/Target","InputField","text","password")# Awaits a FieldInfo | PropertyInfo on the component to become the provided valueassertions.assert_await_component_value_equals(cli,"My/Transform/Target","InputField","text","password")AdvancedTransform Path VariablesIf your client supports variable replacement, you can simply pass them into your paths. For instance if you have different variations on transform path names based on some predictable variable, you can pass those in for replacement.# {deviceFormfactor} is replaced in client...assertions.assert_await_transform_exists(cli,"Kiosk-{deviceFormFactor}(Clone"),timeout_seconds=10)Transform ReferencesIf two or more sibling transforms have the same name, the transform path is ambiguous. This makes it difficult to specify the correct transform, as the example below illustrates:# Suppose both buttons have the same transform path: "Path/To/Menu/Button"# Fetch button0 position using transform pathbutton0_position=commands.fetch_transform_screen_position(cli,"Path/To/Menu/Button")# Can't fetch button1 position using transform path because transform path is ambiguousbutton1_position=# ???To resolve the ambiguity, you can use a transform reference, which supplements the transform path with sibling indices to yield a unique path for each transform. Use thefetch_transformcommand to obtain a transform reference:# Suppose both buttons have the same transform path: "Path/To/Menu/Button"# Obtain a transform referencemenu=commands.fetch_transform(cli,"Path/To/Menu")# Fetch button0 position using transform referencebutton0_position=commands.fetch_transform_screen_position(cli,menu.children[0])# Fetch button1 position using transform referencebutton1_position=commands.fetch_transform_screen_position(cli,menu.children[1])Warning:Transform references are only valid as long as the transform hierarchy doesn't change. If the hierarchy changes (e.g. a transform is created or deleted, or the sibling order changes), you must callfetch_transformagain to obtain updated transform references.