clerk-sdk 0.4.13__py3-none-any.whl → 0.4.15__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
clerk/__init__.py CHANGED
@@ -1,4 +1,4 @@
1
1
  from .client import Clerk
2
2
 
3
3
 
4
- __version__ = "0.4.13"
4
+ __version__ = "0.4.14"
clerk/base.py CHANGED
@@ -50,7 +50,7 @@ class BaseClerk(BaseModel):
50
50
  headers: Dict[str, str] = {},
51
51
  json: Dict[str, Any] = {},
52
52
  params: Dict[str, Any] = {},
53
- ) -> StandardResponse[Dict[str, Any]]:
53
+ ) -> StandardResponse[Any]:
54
54
 
55
55
  merged_headers = {**self.headers, **headers}
56
56
  url = f"{self.base_url}{endpoint}"
@@ -66,7 +66,7 @@ class BaseClerk(BaseModel):
66
66
 
67
67
  @backoff.on_exception(
68
68
  backoff.expo,
69
- (requests.exceptions.RequestException,),
69
+ Exception,
70
70
  max_tries=3,
71
71
  jitter=None,
72
72
  giveup=giveup_handler,
@@ -40,9 +40,18 @@ class RPAClerk(BaseClerk):
40
40
  json={"id": remote_device.id, "name": remote_device.name, "run_id": run_id},
41
41
  )
42
42
 
43
+ def get_wss_token(self) -> str:
44
+ endpoint = "/wss_token"
45
+ res = self.get_request(endpoint=endpoint)
46
+ return res.data[0]
47
+
43
48
  def get_coordinates(self, payload: Dict[str, Any]) -> Coords:
44
49
  endpoint = "/action_model/get_coordinates"
45
- res = self.post_request(endpoint=endpoint, json=payload)
50
+ try:
51
+ res = self.post_request(endpoint=endpoint, json=payload)
52
+ except Exception as e:
53
+ # We always want to be raising RuntimeError here to be caught in the do() method
54
+ raise RuntimeError(f"Failed to get coordinates: {str(e)}") from e
46
55
  if res.data[0] is None: # type: ignore
47
56
  raise RuntimeError("No coordinates found in the response.")
48
57
  return Coords.model_validate(res.data[0])
@@ -1,12 +1,14 @@
1
1
  import asyncio
2
2
  import json
3
3
  import os
4
+ import backoff
4
5
  from typing import Any, Dict, Union
5
6
 
7
+
6
8
  import pydantic
7
9
  import requests
8
10
 
9
-
11
+ from websockets import WebSocketException
10
12
  from .model import (
11
13
  ExecutePayload,
12
14
  DeleteFilesExecutePayload,
@@ -15,12 +17,24 @@ from .model import (
15
17
  WindowExecutePayload,
16
18
  GetFileExecutePayload,
17
19
  )
18
- import backoff
19
20
 
20
21
  from .model import PerformActionResponse, ActionStates
21
22
  from .exception import PerformActionException, GetScreenError
22
23
 
23
24
 
25
+ async def before_retry(details: Any):
26
+ from ..decorators.gui_automation import reconnect_ws
27
+
28
+ await reconnect_ws()
29
+
30
+
31
+ @backoff.on_exception(
32
+ backoff.constant,
33
+ WebSocketException,
34
+ interval=1,
35
+ max_tries=5,
36
+ on_backoff=before_retry,
37
+ )
24
38
  async def _perform_action_ws(payload: Dict[str, Any]) -> PerformActionResponse:
25
39
  """Perform an action over a WebSocket connection.
26
40
 
@@ -48,6 +62,8 @@ async def _perform_action_ws(payload: Dict[str, Any]) -> PerformActionResponse:
48
62
  return PerformActionResponse(**json.loads(action_info))
49
63
  else:
50
64
  raise RuntimeError("Received ACK != OK")
65
+ except WebSocketException as e:
66
+ raise e
51
67
  except asyncio.TimeoutError:
52
68
  raise RuntimeError("The ack message did not arrive.")
53
69
  else:
@@ -32,6 +32,28 @@ REMOTE_DEVICE_ALLOCATION_MAX_TRIES = int(
32
32
  )
33
33
 
34
34
 
35
+ async def connect_to_ws(uri: str) -> ClientConnection:
36
+ # Same knobs as before, just via the new connect()
37
+ return await connect(uri, max_size=2**23, ping_timeout=3600)
38
+
39
+
40
+ async def close_ws_connection(ws_conn: ClientConnection):
41
+ await ws_conn.close()
42
+
43
+
44
+ async def reconnect_ws():
45
+ global global_ws
46
+
47
+ remote_device_name = os.getenv("REMOTE_DEVICE_NAME")
48
+ if not remote_device_name:
49
+ raise RuntimeError(
50
+ "REMOTE_DEVICE_NAME environmental variable is required for reconnecting WebSocket."
51
+ )
52
+ wss_token = clerk_client.get_wss_token()
53
+ uri = f"{wss_uri}/{remote_device_name}/publisher?token={wss_token}"
54
+ global_ws = await connect_to_ws(uri)
55
+
56
+
35
57
  def _allocate_remote_device(
36
58
  clerk_client: RPAClerk, group_name: str, run_id: str
37
59
  ) -> RemoteDevice:
@@ -83,17 +105,11 @@ def gui_automation(
83
105
  if not group_name:
84
106
  raise ValueError("REMOTE_DEVICE_GROUP environmental variable is required.")
85
107
 
86
- async def connect_to_ws(uri: str) -> ClientConnection:
87
- # Same knobs as before, just via the new connect()
88
- return await connect(uri, max_size=2**23, ping_timeout=3600)
89
-
90
- async def close_ws_connection(ws_conn: ClientConnection):
91
- await ws_conn.close()
92
-
93
108
  def decorator(func: Callable):
94
109
  @functools.wraps(func)
95
110
  def wrapper(payload: ClerkCodePayload, *args, **kwargs):
96
111
  global global_ws
112
+
97
113
  force_deallocate = False
98
114
  os.environ["_document_id"] = payload.document.id
99
115
  os.environ["_run_id"] = payload.run_id
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: clerk-sdk
3
- Version: 0.4.13
3
+ Version: 0.4.15
4
4
  Summary: Library for interacting with Clerk
5
5
  Home-page: https://github.com/F-ONE-Group/clerk_pypi
6
6
  Author: F-ONE Group
@@ -1,5 +1,5 @@
1
- clerk/__init__.py,sha256=8vN7q39FUMsGedXrS1tuJ-6tLM55TXCAz8astAma23w,51
2
- clerk/base.py,sha256=S1RKc2pBw2FPlVjefJzsNtyTDPB0UG46C2K_QVV1opA,4008
1
+ clerk/__init__.py,sha256=xGgrQuxBmA5NdRf4kuLF14MHSYwPsVBcmuyxvPhL6TU,51
2
+ clerk/base.py,sha256=lbFTdpdDfsmYIQUFH93S1aw0-L6GNJwAcubW1tdMFX4,3967
3
3
  clerk/client.py,sha256=RdOvC23WK9ZtIXDOYaoSFk9debh3UTmstBXjAswAH6E,4981
4
4
  clerk/decorator/__init__.py,sha256=yGGcS17VsZ7cZ-hVGCm3I3vGDJMiJIAqmDGzriIi0DI,65
5
5
  clerk/decorator/models.py,sha256=nFMdVSG3nJ4hrEXs9YbI_GgjHbVjhSWZokOCzUh-lqQ,521
@@ -8,16 +8,16 @@ clerk/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,
8
8
  clerk/exceptions/exceptions.py,sha256=gSCma06b6W6c0NrA2rhzd5YjFhZGa6caShX07lo-_3E,1291
9
9
  clerk/exceptions/remote_device.py,sha256=R0Vfmk8ejibEFeV29A8Vqst2YA6yxdqEX9lP5wWubgM,134
10
10
  clerk/gui_automation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
11
- clerk/gui_automation/client.py,sha256=V5ytb4_rXy4WznJWmUcDfdTCG6PXKsIJqAgyJ7Qis8M,5151
11
+ clerk/gui_automation/client.py,sha256=lLIim3i9PkdPlt5vmV4u2GoqQ571PHy7EvmRtTBv-JQ,5516
12
12
  clerk/gui_automation/action_model/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
13
13
  clerk/gui_automation/action_model/model.py,sha256=yzaCyEMOH3YMkPBf6IwUMuu69-xyf78HzmthiewgWQY,3811
14
14
  clerk/gui_automation/action_model/utils.py,sha256=xzFxgN-bTK6HKGS7J-esQZ-ePj_yG72T-2ZVhcWvKjw,798
15
15
  clerk/gui_automation/client_actor/__init__.py,sha256=SVuL6-oo1Xc0oJkjMKrO6mJwpPGjrCLKhDV6r2Abtf8,66
16
- clerk/gui_automation/client_actor/client_actor.py,sha256=GFUwUR0QsvuFjRulzETIXLPxBGOX255L1XUUSG15WAY,5117
16
+ clerk/gui_automation/client_actor/client_actor.py,sha256=D2mQAHitF5x-dZzt70ZPw_fZGwuwWTAAwuHXbdKVKfE,5475
17
17
  clerk/gui_automation/client_actor/exception.py,sha256=zdnImHZ88yf52Xq3aMHivEU3aJg-r2c-r8x8XZnI3ic,407
18
18
  clerk/gui_automation/client_actor/model.py,sha256=wVpFCi1w2kh4kAV8oNx489vf_SLUQnqhc02rFD5NIJA,6335
19
19
  clerk/gui_automation/decorators/__init__.py,sha256=OCgXStEumscgT-RyVy5OKS7ml1w9y-lEnjCVnxuRnQs,43
20
- clerk/gui_automation/decorators/gui_automation.py,sha256=jqzN_iqIq2KvjUU-JoYnUSOf-mst31EKCk8zdMFzGQM,5357
20
+ clerk/gui_automation/decorators/gui_automation.py,sha256=6BVT74n4JsPJmD_G_b_MNfEvq3WZAukWbQcAOX2aDPM,5770
21
21
  clerk/gui_automation/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
22
22
  clerk/gui_automation/exceptions/agent_manager.py,sha256=KFWFWQ7X_8Z9XG__SMzb1jKI3yNoVTPJAXzW5O-fSXc,101
23
23
  clerk/gui_automation/exceptions/websocket.py,sha256=-MdwSwlf1hbnu55aDgk3L1znkTZ6xJS6po5VpEGD9ck,117
@@ -45,8 +45,8 @@ clerk/models/ui_operator.py,sha256=mKTJUFZgv7PeEt5oys28HVZxHOJsofmRQOcRpqj0dbU,2
45
45
  clerk/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
46
46
  clerk/utils/logger.py,sha256=NrMIlJfVmRjjRw_N_Jngkl0qqv7btXUbg5wxcRmFEH4,3800
47
47
  clerk/utils/save_artifact.py,sha256=94aYkYNVGcSUaSWZmdjiY6Oc-3yCKb2XWCZ56IAXQqk,1158
48
- clerk_sdk-0.4.13.dist-info/licenses/LICENSE,sha256=GTVQl3vH6ht70wJXKC0yMT8CmXKHxv_YyO_utAgm7EA,1065
49
- clerk_sdk-0.4.13.dist-info/METADATA,sha256=8H4cSbJ1XG8pENpFq-8FtBuhTLvs_0fqhMNqdf4GlY4,9937
50
- clerk_sdk-0.4.13.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
51
- clerk_sdk-0.4.13.dist-info/top_level.txt,sha256=99eQiU6d05_-f41tmSFanfI_SIJeAdh7u9m3LNSfcv4,6
52
- clerk_sdk-0.4.13.dist-info/RECORD,,
48
+ clerk_sdk-0.4.15.dist-info/licenses/LICENSE,sha256=GTVQl3vH6ht70wJXKC0yMT8CmXKHxv_YyO_utAgm7EA,1065
49
+ clerk_sdk-0.4.15.dist-info/METADATA,sha256=5a82iUvHTK2T885B0pUGQMu2px-RzRIUxMKxH8sSd9w,9937
50
+ clerk_sdk-0.4.15.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
51
+ clerk_sdk-0.4.15.dist-info/top_level.txt,sha256=99eQiU6d05_-f41tmSFanfI_SIJeAdh7u9m3LNSfcv4,6
52
+ clerk_sdk-0.4.15.dist-info/RECORD,,