sunholo 0.100.2__py3-none-any.whl → 0.100.3__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.
@@ -1,63 +1,107 @@
1
1
  import asyncio
2
- from ..custom_logging import log
3
- import traceback
4
2
  from typing import Callable, Any, AsyncGenerator, Dict
3
+ import time
4
+ import traceback
5
+ from ..custom_logging import setup_logging
5
6
  from tenacity import AsyncRetrying, retry_if_exception_type, wait_random_exponential, stop_after_attempt
6
7
 
8
+ log = setup_logging("sunholo_AsyncTaskRunner")
9
+
7
10
  class AsyncTaskRunner:
8
11
  def __init__(self, retry_enabled=False, retry_kwargs=None):
9
12
  self.tasks = []
10
13
  self.retry_enabled = retry_enabled
11
14
  self.retry_kwargs = retry_kwargs or {}
12
-
15
+
13
16
  def add_task(self, func: Callable[..., Any], *args: Any):
14
- """Adds a task to the list of tasks to be executed."""
17
+ """
18
+ Adds a task to the list of tasks to be executed.
19
+ """
15
20
  log.info(f"Adding task: {func.__name__} with args: {args}")
16
21
  self.tasks.append((func.__name__, func, args))
17
-
18
- async def run_async_as_completed(self, callback=None) -> AsyncGenerator[Dict[str, Any], None]:
19
- """
20
- Runs all tasks concurrently and yields results as they complete, while periodically sending heartbeat messages.
21
22
 
22
- Args:
23
- callback: The callback object that will receive heartbeat messages.
23
+ async def run_async_as_completed(self) -> AsyncGenerator[Dict[str, Any], None]:
24
+ """
25
+ Runs all tasks concurrently and yields results as they complete,
26
+ while periodically sending heartbeat messages.
24
27
  """
25
28
  log.info("Running tasks asynchronously and yielding results as they complete")
26
- tasks = {}
29
+
30
+ # Create a queue for inter-coroutine communication
31
+ queue = asyncio.Queue()
32
+
33
+ # List to keep track of all running tasks and their heartbeats
34
+ task_infos = []
35
+
36
+ # Start all tasks and their corresponding heartbeats
27
37
  for name, func, args in self.tasks:
28
- # Pass the callback down to _task_wrapper
29
- coro = self._task_wrapper(name, func, args, callback)
30
- task = asyncio.create_task(coro)
31
- tasks[task] = name
32
-
33
- log.info(f"Start async run with {len(self.tasks)} runners")
34
- while tasks:
35
- done, _ = await asyncio.wait(tasks.keys(), return_when=asyncio.FIRST_COMPLETED)
36
- for task in done:
37
- name = tasks.pop(task)
38
- try:
39
- # func_name = message['func_name']; result = message['result']
40
- result = await task
41
- yield {'type':'task_complete', 'func_name': name, 'result': result}
42
- except Exception as e:
43
- log.error(f"Task {name} resulted in an error: {e}\n{traceback.format_exc()}")
44
- yield {'type':'task_error', 'func_name': name, 'error': f'{e}\n{traceback.format_exc()}'}
45
-
46
- async def _task_wrapper(self, name: str, func: Callable[..., Any], args: Any, callback=None) -> Any:
47
- """Wraps the task function to process its output and handle retries, while managing heartbeat updates."""
48
- async def run_func():
49
- if asyncio.iscoroutinefunction(func):
50
- # If the function is async, await it
51
- return await func(*args)
52
- else:
53
- # If the function is sync, run it in a thread to prevent blocking
54
- return await asyncio.to_thread(func, *args)
38
+ # Create an event to signal task completion to the heartbeat
39
+ completion_event = asyncio.Event()
40
+
41
+ # Start the main task with retries
42
+ task_coro = self._run_with_retries(name, func, *args, queue=queue, completion_event=completion_event)
43
+ task = asyncio.create_task(task_coro)
44
+
45
+ # Start the heartbeat coroutine
46
+ heartbeat_coro = self._send_heartbeat(name, completion_event, queue)
47
+ heartbeat_task = asyncio.create_task(heartbeat_coro)
48
+
49
+ # Store task information for management
50
+ task_infos.append({
51
+ 'name': name,
52
+ 'task': task,
53
+ 'heartbeat_task': heartbeat_task,
54
+ 'completion_event': completion_event
55
+ })
56
+
57
+ log.info(f"Started task '{name}' and its heartbeat")
58
+
59
+ log.info(f"Started async run with {len(self.tasks)} tasks and heartbeats")
60
+
61
+ # Create a monitor task to detect when all tasks and heartbeats are done
62
+ monitor = asyncio.create_task(self._monitor_tasks(task_infos, queue))
63
+
64
+ # Continuously yield messages from the queue until sentinel is received
65
+ while True:
66
+ message = await queue.get()
67
+ if message is None:
68
+ log.info("Received sentinel. Exiting message loop.")
69
+ break # Sentinel received, all tasks and heartbeats are done
70
+ log.info(f"Received message from queue: {message}")
71
+ yield message
55
72
 
56
- # Start the heartbeat task if a callback is provided
57
- heartbeat_task = None
58
- if callback:
59
- heartbeat_task = asyncio.create_task(self._send_heartbeat(callback, name))
73
+ # Wait for the monitor to finish
74
+ await monitor
60
75
 
76
+ log.info("All tasks and heartbeats have completed")
77
+
78
+ async def _monitor_tasks(self, task_infos, queue):
79
+ """
80
+ Monitors the tasks and heartbeats, and sends a sentinel to the queue when done.
81
+ """
82
+ # Wait for all main tasks to complete
83
+ main_tasks = [info['task'] for info in task_infos]
84
+ log.info("Monitor: Waiting for all main tasks to complete")
85
+ await asyncio.gather(*main_tasks, return_exceptions=True)
86
+ log.info("Monitor: All main tasks have completed")
87
+
88
+ # Cancel all heartbeat tasks
89
+ for info in task_infos:
90
+ info['heartbeat_task'].cancel()
91
+ try:
92
+ await info['heartbeat_task']
93
+ except asyncio.CancelledError:
94
+ pass
95
+ log.info(f"Monitor: Heartbeat for task '{info['name']}' has been canceled")
96
+
97
+ # Send a sentinel to indicate completion
98
+ await queue.put(None)
99
+ log.info("Monitor: Sent sentinel to queue")
100
+
101
+ async def _run_with_retries(self, name: str, func: Callable[..., Any], *args: Any, queue: asyncio.Queue, completion_event: asyncio.Event) -> None:
102
+ """
103
+ Executes a task with optional retries and sends completion or error messages to the queue.
104
+ """
61
105
  try:
62
106
  if self.retry_enabled:
63
107
  retry_kwargs = {
@@ -68,50 +112,67 @@ class AsyncTaskRunner:
68
112
  }
69
113
  async for attempt in AsyncRetrying(**retry_kwargs):
70
114
  with attempt:
71
- return await run_func()
115
+ log.info(f"Starting task '{name}' with retry")
116
+ result = await self._execute_task(func, *args)
117
+ await queue.put({'type': 'task_complete', 'func_name': name, 'result': result})
118
+ log.info(f"Sent 'task_complete' message for task '{name}'")
119
+ return
72
120
  else:
73
- try:
74
- return await run_func()
75
- except Exception as e:
76
- log.error(f"Error in task {name}: {e}\n{traceback.format_exc()}")
77
- raise
121
+ log.info(f"Starting task '{name}' with no retry")
122
+ result = await self._execute_task(func, *args)
123
+ await queue.put({'type': 'task_complete', 'func_name': name, 'result': result})
124
+ log.info(f"Sent 'task_complete' message for task '{name}'")
125
+ except Exception as e:
126
+ log.error(f"Error in task '{name}': {e}\n{traceback.format_exc()}")
127
+ await queue.put({'type': 'task_error', 'func_name': name, 'error': f'{e}\n{traceback.format_exc()}'})
128
+ log.info(f"Sent 'task_error' message for task '{name}'")
78
129
  finally:
79
- # Stop the heartbeat task
80
- if heartbeat_task:
81
- heartbeat_task.cancel()
82
- try:
83
- await heartbeat_task # Ensure the heartbeat task is properly canceled
84
- except asyncio.CancelledError:
85
- pass
86
-
87
- # Send a message indicating task completion and remove spinner
88
- if callback:
89
- completion_html = (
90
- f"<script>"
91
- f"document.getElementById('{name}-spinner').innerHTML = '✔️ Task {name} completed!';"
92
- f"</script>"
93
- )
94
- await callback.async_on_llm_new_token(token=completion_html)
95
-
96
- async def _send_heartbeat(self, callback, func_name, interval=2):
130
+ log.info(f"Task '{name}' completed.")
131
+ # Set the completion event after sending the message
132
+ completion_event.set()
133
+
134
+ async def _execute_task(self, func: Callable[..., Any], *args: Any) -> Any:
135
+ """
136
+ Executes the given task function and returns its result.
137
+
138
+ Args:
139
+ func (Callable): The callable to execute.
140
+ *args: Arguments to pass to the callable.
141
+
142
+ Returns:
143
+ Any: The result of the task.
144
+ """
145
+ if asyncio.iscoroutinefunction(func):
146
+ return await func(*args)
147
+ else:
148
+ return await asyncio.to_thread(func, *args)
149
+
150
+ async def _send_heartbeat(self, func_name: str, completion_event: asyncio.Event, queue: asyncio.Queue, interval: int = 2):
97
151
  """
98
152
  Sends periodic heartbeat updates to indicate the task is still in progress.
99
153
 
100
154
  Args:
101
- callback: The callback to notify that the task is still working.
102
- func_name: The name of the task function.
103
- interval: How frequently to send heartbeat messages (in seconds).
155
+ func_name (str): The name of the task function.
156
+ completion_event (asyncio.Event): Event to signal when the task is completed.
157
+ queue (asyncio.Queue): The queue to send heartbeat messages to.
158
+ interval (int): How frequently to send heartbeat messages (in seconds).
104
159
  """
105
- # Send the initial spinner HTML
106
- spinner_html = (
107
- f'<div id="{func_name}-spinner" style="display:inline-block; margin: 5px;">'
108
- f'<div class="spinner" style="width:16px; height:16px; border: 2px solid #f3f3f3; '
109
- f'border-radius: 50%; border-top: 2px solid #3498db; animation: spin 1s linear infinite;"></div>'
110
- f'<style>@keyframes spin {{0% {{ transform: rotate(0deg); }} 100% {{ transform: rotate(360deg); }}}}</style>'
111
- f' <span>Task {func_name} is in progress...</span></div>'
112
- )
113
- await callback.async_on_llm_new_token(token=spinner_html)
114
-
115
- # Keep sending heartbeats until task completes
116
- while True:
117
- await asyncio.sleep(interval) # Sleep for the interval but do not send multiple messages
160
+ start_time = time.time()
161
+ log.info(f"Starting heartbeat for task '{func_name}' with interval {interval} seconds")
162
+ try:
163
+ while not completion_event.is_set():
164
+ await asyncio.sleep(interval)
165
+ elapsed_time = int(time.time() - start_time)
166
+ heartbeat_message = {
167
+ 'type': 'heartbeat',
168
+ 'name': func_name,
169
+ 'interval': interval,
170
+ 'elapsed_time': elapsed_time
171
+ }
172
+ log.info(f"Sending heartbeat for task '{func_name}', running for {elapsed_time} seconds")
173
+ await queue.put(heartbeat_message)
174
+ except asyncio.CancelledError:
175
+ log.info(f"Heartbeat for task '{func_name}' has been canceled")
176
+ finally:
177
+ log.info(f"Heartbeat for task '{func_name}' stopped")
178
+
@@ -1,9 +1,9 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: sunholo
3
- Version: 0.100.2
3
+ Version: 0.100.3
4
4
  Summary: Large Language Model DevOps - a package to help deploy LLMs to the Cloud.
5
5
  Home-page: https://github.com/sunholo-data/sunholo-py
6
- Download-URL: https://github.com/sunholo-data/sunholo-py/archive/refs/tags/v0.100.2.tar.gz
6
+ Download-URL: https://github.com/sunholo-data/sunholo-py/archive/refs/tags/v0.100.3.tar.gz
7
7
  Author: Holosun ApS
8
8
  Author-email: multivac@sunholo.com
9
9
  License: Apache License, Version 2.0
@@ -89,7 +89,7 @@ sunholo/genai/init.py,sha256=yG8E67TduFCTQPELo83OJuWfjwTnGZsyACospahyEaY,687
89
89
  sunholo/genai/process_funcs_cls.py,sha256=DPe70E71pofInLMFBFdudFZr0ZCFHN1LFCQjpxtG8xU,26552
90
90
  sunholo/genai/safety.py,sha256=mkFDO_BeEgiKjQd9o2I4UxB6XI7a9U-oOFjZ8LGRUC4,1238
91
91
  sunholo/invoke/__init__.py,sha256=o1RhwBGOtVK0MIdD55fAIMCkJsxTksi8GD5uoqVKI-8,184
92
- sunholo/invoke/async_class.py,sha256=LNe57uxwGwLaN44MCOVOOSMNX8FZ5buqCxevYTHUTPg,5501
92
+ sunholo/invoke/async_class.py,sha256=Wkrv3exjN3aDQdI1Q4tv8I8xSloKgdz_LzGomayfLhw,7734
93
93
  sunholo/invoke/direct_vac_func.py,sha256=GXSCMkC6vOWGUtQjxy-ZpTrMvJa3CgcW-y9mDpJwWC8,9533
94
94
  sunholo/invoke/invoke_vac_utils.py,sha256=sJc1edHTHMzMGXjji1N67c3iUaP7BmAL5nj82Qof63M,2053
95
95
  sunholo/langfuse/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -144,9 +144,9 @@ sunholo/vertex/init.py,sha256=1OQwcPBKZYBTDPdyU7IM4X4OmiXLdsNV30C-fee2scQ,2875
144
144
  sunholo/vertex/memory_tools.py,sha256=tBZxqVZ4InTmdBvLlOYwoSEWu4-kGquc-gxDwZCC4FA,7667
145
145
  sunholo/vertex/safety.py,sha256=S9PgQT1O_BQAkcqauWncRJaydiP8Q_Jzmu9gxYfy1VA,2482
146
146
  sunholo/vertex/type_dict_to_json.py,sha256=uTzL4o9tJRao4u-gJOFcACgWGkBOtqACmb6ihvCErL8,4694
147
- sunholo-0.100.2.dist-info/LICENSE.txt,sha256=SdE3QjnD3GEmqqg9EX3TM9f7WmtOzqS1KJve8rhbYmU,11345
148
- sunholo-0.100.2.dist-info/METADATA,sha256=hkHwKSigiDOe9t6fcubbDM0Osr542-T3R8guKamW2YY,8312
149
- sunholo-0.100.2.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
150
- sunholo-0.100.2.dist-info/entry_points.txt,sha256=bZuN5AIHingMPt4Ro1b_T-FnQvZ3teBes-3OyO0asl4,49
151
- sunholo-0.100.2.dist-info/top_level.txt,sha256=wt5tadn5--5JrZsjJz2LceoUvcrIvxjHJe-RxuudxAk,8
152
- sunholo-0.100.2.dist-info/RECORD,,
147
+ sunholo-0.100.3.dist-info/LICENSE.txt,sha256=SdE3QjnD3GEmqqg9EX3TM9f7WmtOzqS1KJve8rhbYmU,11345
148
+ sunholo-0.100.3.dist-info/METADATA,sha256=c5y87oJoR39hmBJfM3dGVuHKI1e2A5ZJhTyrFaTOSbQ,8312
149
+ sunholo-0.100.3.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
150
+ sunholo-0.100.3.dist-info/entry_points.txt,sha256=bZuN5AIHingMPt4Ro1b_T-FnQvZ3teBes-3OyO0asl4,49
151
+ sunholo-0.100.3.dist-info/top_level.txt,sha256=wt5tadn5--5JrZsjJz2LceoUvcrIvxjHJe-RxuudxAk,8
152
+ sunholo-0.100.3.dist-info/RECORD,,