clerk-sdk 0.2.7__py3-none-any.whl → 0.2.8__py3-none-any.whl

clerk/gui_automation/ui_actions/support.py

@@ -2,7 +2,7 @@ from datetime import timedelta, datetime
 import os
 import base64
 import time
-from typing import Optional
+from typing import List, Optional
 from backoff._typing import Details
 
 from clerk.models.ui_operator import TaskStatuses, UiOperatorTask
@@ -60,6 +60,47 @@ def save_screenshot(filename: str, sub_folder: Optional[str] = None) -> str:
     )
 
 
+def try_actions(actions: List[BaseAction]):
+    """
+    Executes a list of UI actions and handles any errors that occur.
+
+    This function takes a list of UI actions as input and executes them one by one.
+    If an action fails with a RuntimeError, it logs a warning message and moves on to the next action.
+    If all actions fail, it logs an error message and raises a RuntimeError.
+
+    Args:
+        actions (List[BaseAction]): A list of UI actions to be executed.
+
+    Raises:
+        TypeError: If any of the actions in the list is not an instance of BaseAction.
+        RuntimeError: If all actions fail.
+
+    Returns:
+        None
+
+    Example Usage:
+        actions = [action1, action2, action3]
+        try_actions(actions)
+    """
+    try:
+        assert all(isinstance(action, BaseAction) for action in actions)
+        for action in actions:
+            try:
+                action.do()
+                return
+            except RuntimeError as e:
+                logger.warning(
+                    f"The action {action} was not performed successfully.\nDetails: {str(e)}",
+                )
+        # all the actions have failed. log an error and raise a runtime error
+        logger.error("All actions have failed.")
+        raise RuntimeError("All actions have failed")
+    except AssertionError as e:
+        raise TypeError(
+            f"All actions must be valid. Encountered invalid action: {str(e)}"
+        )
+
+
 def _format_action_string(action: BaseAction) -> str:
     """
     Formats action in the same format as the one used in task modules.

{clerk_sdk-0.2.7.dist-info → clerk_sdk-0.2.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clerk-sdk
-Version: 0.2.7
+Version: 0.2.8
 Summary: Library for interacting with Clerk
 Home-page: https://github.com/F-ONE-Group/clerk_pypi
 Author: F-ONE Group

{clerk_sdk-0.2.7.dist-info → clerk_sdk-0.2.8.dist-info}/RECORD

@@ -23,7 +23,7 @@ clerk/gui_automation/exceptions/modality/exc.py,sha256=P-dMuCTyVZYD3pbGpCf_1SYEg
 clerk/gui_automation/ui_actions/__init__.py,sha256=-EDQ5375HXrvG3sfFY7zOPC405YcBL6xXRACm2p-YyI,23
 clerk/gui_automation/ui_actions/actions.py,sha256=hhxl5VMDNSXdqm2L0tZqs6IhJHVXtlSVSdwsiz2BbDI,27449
 clerk/gui_automation/ui_actions/base.py,sha256=4CjOkMZNLt8W0tLO91tOkz8CCea0m2IRBIOpWNMOZUA,7230
-clerk/gui_automation/ui_actions/support.py,sha256=83D-oVmZxD507kh9-8PsoXt5zD4o225TmkmS0Kh_8Zo,4330
+clerk/gui_automation/ui_actions/support.py,sha256=Ulb8DBfwnrBMaYoMLDgldEy9V--NDUSdhIYXpuODZoU,5772
 clerk/gui_automation/ui_state_inspector/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 clerk/gui_automation/ui_state_inspector/gui_vision.py,sha256=lRnF3IMLViOB-UE447A4kc8BO7NKqqLV1NZKRswRKWg,7707
 clerk/gui_automation/ui_state_inspector/models.py,sha256=uuzYhE9is4Z-TmsVMA1mwf0mQGs_PDLqdSZKbe8dHSs,5691
@@ -43,8 +43,8 @@ clerk/models/ui_operator.py,sha256=mKTJUFZgv7PeEt5oys28HVZxHOJsofmRQOcRpqj0dbU,2
 clerk/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 clerk/utils/logger.py,sha256=_jYOSEc1WCsY9DvU8cIWUPmz41QNjpHTEZ7WrUnmFPA,3650
 clerk/utils/save_artifact.py,sha256=Lwl3l3QqKnSFLFpfEEa-dJ-dV9OxvCU3ADkuYZ18U-Q,1117
-clerk_sdk-0.2.7.dist-info/licenses/LICENSE,sha256=GTVQl3vH6ht70wJXKC0yMT8CmXKHxv_YyO_utAgm7EA,1065
-clerk_sdk-0.2.7.dist-info/METADATA,sha256=tNJBhP9i4zm0UyCCr-BBTdmrHH42QgA6IWX9YkY4ApU,3508
-clerk_sdk-0.2.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-clerk_sdk-0.2.7.dist-info/top_level.txt,sha256=99eQiU6d05_-f41tmSFanfI_SIJeAdh7u9m3LNSfcv4,6
-clerk_sdk-0.2.7.dist-info/RECORD,,
+clerk_sdk-0.2.8.dist-info/licenses/LICENSE,sha256=GTVQl3vH6ht70wJXKC0yMT8CmXKHxv_YyO_utAgm7EA,1065
+clerk_sdk-0.2.8.dist-info/METADATA,sha256=IrsGA9xl2v4g6Pyai2o09RWSl8AyoeWRekLNDfFUu3o,3508
+clerk_sdk-0.2.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+clerk_sdk-0.2.8.dist-info/top_level.txt,sha256=99eQiU6d05_-f41tmSFanfI_SIJeAdh7u9m3LNSfcv4,6
+clerk_sdk-0.2.8.dist-info/RECORD,,