osbot-utils 2.29.0__py3-none-any.whl → 2.31.0__py3-none-any.whl

osbot_utils/{testing → helpers/duration}/Duration.py

@@ -1,32 +1,11 @@
-import inspect
-from datetime import timedelta
-from functools import wraps
+from datetime                       import timedelta
 
-from osbot_utils.utils.Call_Stack import Call_Stack
+from osbot_utils.helpers.duration.schemas.Schema__Duration import Schema__Duration
+from osbot_utils.utils.Call_Stack   import Call_Stack
+from osbot_utils.utils.Misc         import date_time_now, time_delta_to_str
 
-from osbot_utils.utils.Misc import date_time_now, time_delta_to_str
 
-
-def duration(func):
-    if inspect.iscoroutinefunction(func):
-        # It's an async function
-        @wraps(func)
-        async def async_wrapper(*args, **kwargs):
-            with Duration(prefix=f'.{func.__name__} took'):
-                return await func(*args, **kwargs)
-        return async_wrapper
-    else:
-        # It's a regular function
-        @wraps(func)
-        def sync_wrapper(*args, **kwargs):
-            with Duration(prefix=f'.{func.__name__} took'):
-                return func(*args, **kwargs)
-        return sync_wrapper
-
-class Duration:
-    """
-    Helper class for to capture time duration
-    """
+class Duration:                                     # Helper class for to capture time duration
     def __init__(self, prefix="\nDuration:", print_result=True, use_utc=True, print_stack=False):
         self.use_utc            = use_utc
         self.print_result       = print_result
@@ -47,6 +26,15 @@ class Duration:
     def __exit__(self, exception_type, exception_value, exception_traceback):
         self.end()
 
+    def data(self) -> Schema__Duration: # Returns the duration data in Schema__Duration format.
+        if not self.duration:
+            raise ValueError("Duration has not been calculated yet. Call end() first.")
+
+        return Schema__Duration( utc                = self.use_utc               ,
+                                 timestamp_start    = self.start_time.timestamp(),
+                                 timestamp_end      = self.end_time  .timestamp(),
+                                 duration_seconds   = self.seconds             ())
+
     def start(self):
         self.start_time = date_time_now(use_utc=self.use_utc, return_str=False)
 

osbot_utils/helpers/duration/decorators/duration.py

@@ -0,0 +1,21 @@
+import inspect
+from functools import wraps
+
+from osbot_utils.helpers.duration.Duration import Duration
+
+
+def duration(func):
+    if inspect.iscoroutinefunction(func):
+        # It's an async function
+        @wraps(func)
+        async def async_wrapper(*args, **kwargs):
+            with Duration(prefix=f'.{func.__name__} took'):
+                return await func(*args, **kwargs)
+        return async_wrapper
+    else:
+        # It's a regular function
+        @wraps(func)
+        def sync_wrapper(*args, **kwargs):
+            with Duration(prefix=f'.{func.__name__} took'):
+                return func(*args, **kwargs)
+        return sync_wrapper

osbot_utils/{context_managers → helpers/duration/decorators}/print_duration.py

@@ -1,4 +1,4 @@
-from osbot_utils.context_managers.capture_duration import capture_duration
+from osbot_utils.helpers.duration.decorators.capture_duration import capture_duration
 
 
 class print_duration(capture_duration):

osbot_utils/helpers/duration/schemas/Schema__Duration.py

@@ -0,0 +1,8 @@
+from osbot_utils.type_safe.Type_Safe import Type_Safe
+
+
+class Schema__Duration(Type_Safe):
+    utc             : bool = True
+    timestamp_start : float
+    timestamp_end   : float
+    duration_seconds: float

osbot_utils/helpers/flows/Flow.py

@@ -1,21 +1,21 @@
 import asyncio
 import logging
 import typing
-
-from osbot_utils.helpers.Dependency_Manager                 import Dependency_Manager
-from osbot_utils.helpers.flows.actions.Flow__Data           import Flow__Data
-from osbot_utils.helpers.flows.models.Flow_Run__Event       import Flow_Run__Event
-from osbot_utils.type_safe.Type_Safe                        import Type_Safe
-from osbot_utils.helpers.CFormat                            import CFormat, f_dark_grey, f_magenta, f_bold
-from osbot_utils.helpers.flows.models.Flow_Run__Config      import Flow_Run__Config
-from osbot_utils.helpers.flows.actions.Flow__Events         import flow_events
-from osbot_utils.helpers.flows.models.Flow_Run__Event_Data  import Flow_Run__Event_Data
-from osbot_utils.testing.Stdout                             import Stdout
-from osbot_utils.utils.Dev                                  import pprint
-from osbot_utils.utils.Misc                                 import random_id, lower, time_now
-from osbot_utils.utils.Python_Logger                        import Python_Logger
-from osbot_utils.utils.Str                                  import ansis_to_texts
-from osbot_utils.utils.Threads                              import invoke_in_new_event_loop
+from osbot_utils.helpers.Dependency_Manager                     import Dependency_Manager
+from osbot_utils.helpers.flows.actions.Flow__Data               import Flow__Data
+from osbot_utils.helpers.flows.actions.Flow__Stats__Collector   import Flow__Stats__Collector
+from osbot_utils.helpers.flows.models.Flow_Run__Event           import Flow_Run__Event
+from osbot_utils.type_safe.Type_Safe                            import Type_Safe
+from osbot_utils.helpers.CFormat                                import CFormat, f_dark_grey, f_magenta, f_bold
+from osbot_utils.helpers.flows.models.Flow_Run__Config          import Flow_Run__Config
+from osbot_utils.helpers.flows.actions.Flow__Events             import flow_events
+from osbot_utils.helpers.flows.models.Flow_Run__Event_Data      import Flow_Run__Event_Data
+from osbot_utils.testing.Stdout                                 import Stdout
+from osbot_utils.utils.Dev                                      import pprint
+from osbot_utils.utils.Misc                                     import random_id, lower, time_now
+from osbot_utils.utils.Python_Logger                            import Python_Logger
+from osbot_utils.utils.Str                                      import ansis_to_texts
+from osbot_utils.utils.Threads                                  import invoke_in_new_event_loop
 
 FLOW__RANDOM_ID__PREFIX    = 'flow_id__'
 FLOW__RANDOM_NAME__PREFIX  = 'flow_name__'
@@ -23,9 +23,10 @@ FLOW__LOGGING__LOG_FORMAT  = '%(asctime)s.%(msecs)03d | %(levelname)-8s | %(mess
 FLOW__LOGGING__DATE_FORMAT = '%H:%M:%S'
 
 
-# todo: add flow duration
+# todo: replace the flow_id (and task_id) with either Obj_Id or Safe_Id
 class Flow(Type_Safe):
     flow_data          : Flow__Data
+    flow_stats         : Flow__Stats__Collector
     captured_exec_logs : list
     data               : dict                   # dict available to the tasks to add and collect data
     flow_id            : str                    # rename to flow_run_id (or also capture the flow_run_id)
@@ -82,6 +83,7 @@ class Flow(Type_Safe):
 
     def execute_flow(self, flow_run_params=None):                               # todo: see if it makes more sense to call this start_flow_run
         self.check_setup()
+        self.flow_stats.start(flow_id=self.flow_id, flow_name=self.flow_name)   # start the flow stats collector
         flow_events.on__flow__start(self.flow_event_data())
         self.log_debug(f"Created flow run '{self.f__flow_id()}' for flow '{self.f__flow_name()}'")
         self.set_flow_run_params(flow_run_params)
@@ -101,6 +103,7 @@ class Flow(Type_Safe):
             self.log_error(self.cformat.red(f"Error executing flow: {error}"))
             self.flow_data.set_error(error)
 
+        self.flow_stats.end             (self.flow_error)
         self.log_captured_stdout        (stdout)
         self.print_flow_return_value    ()
         self.print_flow_finished_message()

osbot_utils/helpers/flows/Task.py

@@ -2,14 +2,15 @@ import inspect
 import traceback
 import typing
 
-from osbot_utils.helpers.flows.models.Flow_Run__Event_Data  import Flow_Run__Event_Data
-from osbot_utils.utils.Misc                                 import random_id, lower
-from osbot_utils.helpers.Dependency_Manager                 import Dependency_Manager
-from osbot_utils.helpers.flows.actions.Flow__Events         import flow_events
-from osbot_utils.testing.Stdout                             import Stdout
-from osbot_utils.helpers.CFormat                            import CFormat, f_dark_grey, f_red, f_blue, f_bold
-from osbot_utils.type_safe.Type_Safe                        import Type_Safe
-from osbot_utils.helpers.flows.Flow                         import Flow
+from osbot_utils.helpers.flows.actions.Task__Stats__Collector import Task__Stats__Collector
+from osbot_utils.helpers.flows.models.Flow_Run__Event_Data    import Flow_Run__Event_Data
+from osbot_utils.utils.Misc                                   import random_id, lower
+from osbot_utils.helpers.Dependency_Manager                   import Dependency_Manager
+from osbot_utils.helpers.flows.actions.Flow__Events           import flow_events
+from osbot_utils.testing.Stdout                               import Stdout
+from osbot_utils.helpers.CFormat                              import CFormat, f_dark_grey, f_red, f_blue, f_bold
+from osbot_utils.type_safe.Type_Safe                          import Type_Safe
+from osbot_utils.helpers.flows.Flow                           import Flow
 
 TASK__RANDOM_ID__PREFIX    = 'task_id__'
 
@@ -18,6 +19,7 @@ TASK__RANDOM_ID__PREFIX    = 'task_id__'
 class Task(Type_Safe):
     data                : dict                          # dict available to the task to add and collect data
     task_id             : str
+    task_stats          : Task__Stats__Collector
     task_name           : str                           # make this the function mame
     cformat             : CFormat
     resolved_args       : tuple
@@ -63,6 +65,9 @@ class Task(Type_Safe):
         if not self.task_id:
             self.task_id = self.random_task_id()
 
+        execution_order = self.task_flow.flow_stats.get_next_execution_order()
+        self.task_stats.start(flow_id=self.task_flow.flow_id, task_id=self.task_id, task_name=self.task_name, execution_order=execution_order)
+
         self.on_task_start()
         flow_events.on__task__start(self.task_event_data())
 
@@ -105,6 +110,11 @@ class Task(Type_Safe):
         self.task_flow.log_captured_stdout(stdout)
 
     def execute__after(self):
+
+        self.task_stats.end(task_error=self.task_error)
+        self.task_flow.flow_stats.add_task_stats(self.task_stats.stats)
+
+
         self.print_task_return_value()
 
         if self.task_error:

osbot_utils/helpers/flows/actions/Flow__Data.py

@@ -5,7 +5,6 @@ from osbot_utils.helpers.flows.models.Schema__Flow__Artifact    import Schema__F
 from osbot_utils.helpers.flows.models.Schema__Flow__Result      import Schema__Flow__Result
 from osbot_utils.helpers.flows.schemas.Schema__Flow             import Schema__Flow
 from osbot_utils.helpers.flows.schemas.Schema__Flow__Data       import Schema__Flow__Data
-#from osbot_utils.helpers.flows.schemas.Schema__Flow__Event     import Schema__Flow__Event
 from osbot_utils.helpers.flows.schemas.Schema__Flow__Log        import Schema__Flow__Log
 from osbot_utils.helpers.flows.schemas.Schema__Flow__Task__Data import Schema__Flow__Task__Data
 from osbot_utils.type_safe.Type_Safe                            import Type_Safe

osbot_utils/helpers/flows/actions/Flow__Stats__Collector.py

@@ -0,0 +1,47 @@
+from typing                                                  import Dict
+from osbot_utils.helpers.duration.Duration                   import Duration
+from osbot_utils.helpers.flows.schemas.Schema__Flow__Status  import Schema__Flow__Status
+from osbot_utils.helpers.flows.schemas.Schema__Task__Stats   import Schema__Task__Stats
+from osbot_utils.helpers.flows.schemas.Schema__Flow__Stats   import Schema__Flow__Stats
+from osbot_utils.type_safe.Type_Safe                         import Type_Safe
+
+
+class Flow__Stats__Collector(Type_Safe):
+    duration               : Duration
+    stats                  : Schema__Flow__Stats
+    task_execution_counter : int
+
+    def start(self, flow_id: str, flow_name:str):
+        self.duration.print_result = False
+        self.duration.start()
+        self.task_execution_counter = 0
+        with self.stats as _:
+            _.flow_id      = flow_id
+            _.flow_name    = flow_name
+            _.status       = Schema__Flow__Status.RUNNING
+        return self
+
+    def end(self, flow_error:Exception):
+        self.duration.end()
+        with self.stats as _:
+            _.duration     = self.duration.data()
+            _.total_tasks  = len(self.stats.tasks_stats)
+            _.failed_tasks = sum(1 for task in self.stats.tasks_stats.values() if task.status == Schema__Flow__Status.FAILED)
+
+            if flow_error:
+                _.status = Schema__Flow__Status.FAILED
+                _.error_message = str(flow_error)
+            else:
+                _.status = Schema__Flow__Status.COMPLETED
+        return self
+
+    def get_next_execution_order(self):                                                                                 # Get the next execution order number and increment the counter."""
+        self.task_execution_counter += 1
+        return self.task_execution_counter
+
+    def add_task_stats(self, task_stats: Schema__Task__Stats):                                                          # Add task stats to the collection.
+        self.stats.tasks_stats[task_stats.task_id] = task_stats
+        return self
+
+    def json(self):                                                                                                     # Return JSON representation of the stats.
+        return self.stats.json()

osbot_utils/helpers/flows/actions/Task__Stats__Collector.py

@@ -0,0 +1,34 @@
+from osbot_utils.helpers.duration.Duration                  import Duration
+from osbot_utils.helpers.flows.schemas.Schema__Flow__Status import Schema__Flow__Status
+from osbot_utils.helpers.flows.schemas.Schema__Task__Stats  import Schema__Task__Stats
+from osbot_utils.type_safe.Type_Safe                        import Type_Safe
+
+class Task__Stats__Collector(Type_Safe):
+    duration       : Duration
+    stats          : Schema__Task__Stats
+
+    def start(self, flow_id: str, task_id: str, task_name: str , execution_order:int):
+        self.duration.print_result = False
+        self.duration.start()
+        with self.stats as _:
+            _.parent_flow_id  = flow_id
+            _.execution_order = execution_order
+            _.status          = Schema__Flow__Status.RUNNING
+            _.task_id         = task_id
+            _.task_name       = task_name
+        return self
+
+    def end(self, task_error: Exception):
+        self.duration.end()
+        with self.stats as _:
+            _.duration = self.duration.data()
+            if task_error:
+                _.status        = Schema__Flow__Status.FAILED
+                _.error_message = str(task_error)
+            else:
+                _.status = Schema__Flow__Status.COMPLETED
+        return self
+
+
+    def json(self):                                                                                                     # Return JSON representation of the stats.
+        return self.stats.json()

osbot_utils/helpers/flows/schemas/Schema__Flow__Stats.py

@@ -0,0 +1,16 @@
+from typing                                                 import Dict
+from osbot_utils.helpers.duration.schemas.Schema__Duration  import Schema__Duration
+from osbot_utils.helpers.flows.schemas.Schema__Flow__Status import Schema__Flow__Status
+from osbot_utils.helpers.flows.schemas.Schema__Task__Stats  import Schema__Task__Stats
+from osbot_utils.type_safe.Type_Safe                        import Type_Safe
+
+
+class Schema__Flow__Stats(Type_Safe):
+    duration     : Schema__Duration                         # How long the flow took to execute
+    error_message: str                             =  None  # Error message if flow failed
+    failed_tasks : int                                      # Number of failed tasks
+    flow_id      : str                                      # Unique identifier for the flow
+    flow_name    : str                                      # Name of the flow
+    status       : Schema__Flow__Status                     # 'completed', 'failed', 'running'
+    tasks_stats  : Dict[str, Schema__Task__Stats]           # Map of task_id to task stats
+    total_tasks  : int                                      # Total number of tasks executed

osbot_utils/helpers/flows/schemas/Schema__Flow__Status.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+class Schema__Flow__Status(Enum):
+    COMPLETED: str = 'completed'
+    FAILED   : str = 'failed'
+    STOPPED  : str = 'stopped'
+    RUNNING  : str = 'running'

osbot_utils/helpers/flows/schemas/Schema__Task__Stats.py

@@ -0,0 +1,13 @@
+from osbot_utils.helpers.duration.schemas.Schema__Duration  import Schema__Duration
+from osbot_utils.helpers.flows.schemas.Schema__Flow__Status import Schema__Flow__Status
+from osbot_utils.type_safe.Type_Safe                        import Type_Safe
+
+
+class Schema__Task__Stats(Type_Safe):
+    task_id        : str                        # Unique identifier for the task
+    task_name      : str                        # Name of the task
+    execution_order: int                        # Order in which the task was executed
+    duration       : Schema__Duration           # How long the task took to execute
+    status         : Schema__Flow__Status       # 'completed', 'failed', 'running'
+    parent_flow_id : str                        # ID of the flow that contains this task
+    error_message  : str           = None       # Error message if task failed

osbot_utils/helpers/ssh/SCP.py

@@ -1,9 +1,9 @@
-from osbot_utils.context_managers.capture_duration  import capture_duration
-from osbot_utils.helpers.ssh.SSH__Execute           import SSH__Execute
-from osbot_utils.testing.Temp_Zip                   import Temp_Zip
-from osbot_utils.utils.Files                        import file_not_exists, file_name
-from osbot_utils.utils.Process                      import start_process
-from osbot_utils.utils.Status                       import status_error
+from osbot_utils.helpers.duration.decorators.capture_duration  import capture_duration
+from osbot_utils.helpers.ssh.SSH__Execute                      import SSH__Execute
+from osbot_utils.testing.Temp_Zip                              import Temp_Zip
+from osbot_utils.utils.Files                                   import file_not_exists, file_name
+from osbot_utils.utils.Process                                 import start_process
+from osbot_utils.utils.Status                                  import status_error
 
 
 

osbot_utils/helpers/ssh/SSH__Execute.py

@@ -1,13 +1,13 @@
-from osbot_utils.type_safe.Type_Safe import Type_Safe
-from osbot_utils.context_managers.capture_duration          import capture_duration
-from osbot_utils.decorators.lists.group_by                  import group_by
-from osbot_utils.decorators.lists.index_by                  import index_by
-from osbot_utils.utils.Dev                                  import pprint
-from osbot_utils.utils.Env                                  import get_env
-from osbot_utils.utils.Http import is_port_open
-from osbot_utils.utils.Misc                                 import str_to_int, str_to_bool
-from osbot_utils.utils.Process import start_process, run_process
-from osbot_utils.utils.Status                               import status_error
+from osbot_utils.type_safe.Type_Safe                            import Type_Safe
+from osbot_utils.helpers.duration.decorators.capture_duration   import capture_duration
+from osbot_utils.decorators.lists.group_by                      import group_by
+from osbot_utils.decorators.lists.index_by                      import index_by
+from osbot_utils.utils.Dev                                      import pprint
+from osbot_utils.utils.Env                                      import get_env
+from osbot_utils.utils.Http                                     import is_port_open
+from osbot_utils.utils.Misc                                     import str_to_int, str_to_bool
+from osbot_utils.utils.Process                                  import start_process, run_process
+from osbot_utils.utils.Status                                   import status_error
 
 ENV_VAR__SSH__HOST              = 'SSH__HOST'
 ENV_VAR__SSH__PORT              = 'SSH__PORT'

osbot_utils/testing/Hook_Method.py

@@ -1,7 +1,8 @@
-from osbot_utils.helpers.Print_Table import Print_Table
-from osbot_utils.utils.Call_Stack import Call_Stack
+from osbot_utils.helpers.Print_Table            import Print_Table
+from osbot_utils.helpers.duration.Duration      import Duration
+from osbot_utils.utils.Call_Stack               import Call_Stack
+
 
-from osbot_utils.testing.Duration import Duration
 
 class Hook_Method:
 

osbot_utils/type_safe/shared/Type_Safe__Shared__Variables.py

@@ -1,4 +1,8 @@
 import types
 from enum import EnumMeta
 
-IMMUTABLE_TYPES = (bool, int, float, complex, str, bytes, types.NoneType, EnumMeta, type)
+from osbot_utils.helpers.Safe_Id            import Safe_Id
+
+IMMUTABLE_TYPES = (bool, int, float, complex, str, bytes, types.NoneType, EnumMeta, type,
+                   Safe_Id          # ok to add since these classes use str as a base class
+                   )

osbot_utils/type_safe/steps/Type_Safe__Step__From_Json.py

@@ -141,9 +141,14 @@ class Type_Safe__Step__From_Json:
             if key_origin is type:
                 if type(dict_key) is str:
                     dict_key = self.deserialize_type__using_value(dict_key)
-                expected_dict_type = get_args(key_class)[0]
-                if dict_key != expected_dict_type and not issubclass(dict_key,expected_dict_type):
-                    raise TypeError(f"Expected {expected_dict_type} class for key but got instance: {dict_key}")
+                key_class_args = get_args(key_class)
+                if key_class_args:
+                    expected_dict_type = key_class_args[0]
+                    if dict_key != expected_dict_type and not issubclass(dict_key,expected_dict_type):
+                        raise TypeError(f"Expected {expected_dict_type} class for key but got instance: {dict_key}")
+                else:
+                    if not isinstance(dict_key, key_class):
+                        raise TypeError(f"Expected {key_class} class for key but got instance: {dict_key}")
                 new__dict_key = dict_key
             elif issubclass(key_class, Type_Safe):
                 new__dict_key = self.deserialize_from_dict(key_class(), dict_key)
@@ -171,7 +176,7 @@ class Type_Safe__Step__From_Json:
         if type(json_data) is str:
             json_data = json_parse(json_data)
         if json_data:                                           # if there is no data or is {} then don't create an object (since this could be caused by bad data being provided)
-            return self.deserialize_from_dict(_cls(), json_data,raise_on_not_found=raise_on_not_found)
+            return self.deserialize_from_dict(_cls(), json_data, raise_on_not_found=raise_on_not_found)
         return _cls()
 
 type_safe_step_from_json = Type_Safe__Step__From_Json()

osbot_utils/version

@@ -1 +1 @@
-v2.29.0
+v2.31.0

{osbot_utils-2.29.0.dist-info → osbot_utils-2.31.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: osbot_utils
-Version: 2.29.0
+Version: 2.31.0
 Summary: OWASP Security Bot - Utils
 License: MIT
 Author: Dinis Cruz
@@ -23,7 +23,7 @@ Description-Content-Type: text/markdown
 
 Powerful Python util methods and classes that simplify common apis and tasks.
 
-![Current Release](https://img.shields.io/badge/release-v2.29.0-blue)
+![Current Release](https://img.shields.io/badge/release-v2.31.0-blue)
 [![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
 
 

{osbot_utils-2.29.0.dist-info → osbot_utils-2.31.0.dist-info}/RECORD

@@ -5,9 +5,7 @@ osbot_utils/base_classes/Kwargs_To_Self.py,sha256=3LRFpxdg9RBuUlIacF1Bwq014NXtJm
 osbot_utils/base_classes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/context_managers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/context_managers/async_invoke.py,sha256=-ja3K8orLy8Of54CIYSK-zn443pOIDY2hnFBjVELrXc,829
-osbot_utils/context_managers/capture_duration.py,sha256=8ObmbP9_qfYtxx30NGXThRE_E1XZ5IXtX9PHWqtLGfs,1240
 osbot_utils/context_managers/disable_root_loggers.py,sha256=0-zQk11TBqwhTHCN4vNhDApojtJ4oR0oMPRcwclcXZA,960
-osbot_utils/context_managers/print_duration.py,sha256=jleIYxmz-vbWbcZZPuTWMNavJgxYkATwrVk5H-2SHj4,272
 osbot_utils/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/decorators/classes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/decorators/classes/singleton.py,sha256=ZBYw2W4Qmo0mlHQQqDJyScaXO6pmbftru9YBBdUowjY,332
@@ -136,11 +134,21 @@ osbot_utils/helpers/cache_requests/Cache__Requests__Row.py,sha256=Sb7E_zDB-LPlWI
 osbot_utils/helpers/cache_requests/Cache__Requests__Table.py,sha256=BW7tXM0TFYma3Db4M-58IKpx0vevLuFsH7QQeiggPaI,388
 osbot_utils/helpers/cache_requests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/cache_requests/flows/flow__Cache__Requests.py,sha256=xgx_oExxkcvRwQN1UCobimECIMUKGoIX5oGdCmp8Nyw,243
-osbot_utils/helpers/flows/Flow.py,sha256=eSqv_pY7vDC1XmX65RyW4swnhQNtMwZXkXnc4De2oc0,13239
-osbot_utils/helpers/flows/Task.py,sha256=AQ69b97woemCZxxBxluV5pqOlBU0KW4OpculC5Ix4nw,6605
+osbot_utils/helpers/duration/Duration.py,sha256=KvHaAB6NWa40DXQl2gC9m98gM-arVP-aYqFrmAyQQzM,2306
+osbot_utils/helpers/duration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/helpers/duration/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/helpers/duration/decorators/capture_duration.py,sha256=8ObmbP9_qfYtxx30NGXThRE_E1XZ5IXtX9PHWqtLGfs,1240
+osbot_utils/helpers/duration/decorators/duration.py,sha256=ucJP1fCQEN8ALCDCG9CPzPn1KqojD4ttFc3HLke-nvY,651
+osbot_utils/helpers/duration/decorators/print_duration.py,sha256=w7k3OPiRkL5KqLv0S5o1NVo2y_TeOOvDOb-51YbJjAc,283
+osbot_utils/helpers/duration/schemas/Schema__Duration.py,sha256=-h32wBcpiVRkEbc_sZoamnRFNGaQQM4YsxqoVzPGe38,209
+osbot_utils/helpers/duration/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/helpers/flows/Flow.py,sha256=dFjD3czAZDKvcCCk5yeVdpOWCVWvsn5D_q2AnO8340k,13653
+osbot_utils/helpers/flows/Task.py,sha256=RfccOCev5XTsNoKuDJzK1JItF-Lm7P6FGCGZyh9swyY,7116
 osbot_utils/helpers/flows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/flows/actions/Flow__Data.py,sha256=h9h5yVFIK0ZdXukNFgfRVV1XW0YQartVMcJTakwVqKY,5155
+osbot_utils/helpers/flows/actions/Flow__Data.py,sha256=rgUggQo_z6KLtNa92KfzRG6ORdT_8ic5zJVuhk_st38,5064
 osbot_utils/helpers/flows/actions/Flow__Events.py,sha256=g7KBafFeA7tV-v31v_m3MT__cZEX63gh8CehnZwRYU0,2840
+osbot_utils/helpers/flows/actions/Flow__Stats__Collector.py,sha256=GOxXUjDXCQs6cx1BQ9Z_a5KpUI4ztZHaQ-L7-85Ybpc,2276
+osbot_utils/helpers/flows/actions/Task__Stats__Collector.py,sha256=rDYABaHpikIAK0Odleu8-dZ9ECJZYDmgFdd0KvsbByI,1462
 osbot_utils/helpers/flows/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/flows/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/flows/decorators/flow.py,sha256=7wj5TtUO_ffbACnagZtZ6LfFgclmbQSfn2lKkMMrnJI,670
@@ -157,7 +165,10 @@ osbot_utils/helpers/flows/schemas/Schema__Flow__Data.py,sha256=cqSreXlumqPnM_DfF
 osbot_utils/helpers/flows/schemas/Schema__Flow__Event.py,sha256=aeoJotmkYgtEsxyLp6YxoblQFscdAzadI5WOsfYG6-s,616
 osbot_utils/helpers/flows/schemas/Schema__Flow__Event__Data.py,sha256=ugevIeeNIcXiusQiw8BqXikpl_BXvKZrZLZjYg5J9SQ,567
 osbot_utils/helpers/flows/schemas/Schema__Flow__Log.py,sha256=OUjnExtlHlDZYQ8o2wLl_oRCUBu7rEoAjX_5__yaRI8,392
+osbot_utils/helpers/flows/schemas/Schema__Flow__Stats.py,sha256=2YeYHTs7rlA5wGt9Jowr0z3b4ZzZF-0GGx_tCSttjOs,1171
+osbot_utils/helpers/flows/schemas/Schema__Flow__Status.py,sha256=3DSUTPqggnJhpHQAtGhiWj8zT2yRbq6MIQk31ap_5ds,181
 osbot_utils/helpers/flows/schemas/Schema__Flow__Task__Data.py,sha256=BQQvR02n1YAT59I70GT06MBdJbgaDnZBGhaV9Q90oBQ,657
+osbot_utils/helpers/flows/schemas/Schema__Task__Stats.py,sha256=DSja48dPeQPBzzJMtKjJrwEEHb4MqBv0nvm2YC_pTpk,858
 osbot_utils/helpers/flows/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/generators/Generator_Context_Manager.py,sha256=STpCn2Zh5G2TmyYMjeLMjfpkSYUUeU6mzV_O6Hu4g4Q,863
 osbot_utils/helpers/generators/Generator_Manager.py,sha256=XxE7ZZvziorolEM5FoMq-5yOFUi3yVaWcPB_XWHtm30,11728
@@ -233,10 +244,10 @@ osbot_utils/helpers/sqlite/tables/Sqlite__Table__Edges.py,sha256=YwlWj9GYBDeotqD
 osbot_utils/helpers/sqlite/tables/Sqlite__Table__Files.py,sha256=4YguiuqzcfTadPWV67lN4IU_8xJzJF--ZRMqbEyzXqw,3800
 osbot_utils/helpers/sqlite/tables/Sqlite__Table__Nodes.py,sha256=GT8h3wD4hGvEtqQuBs0sBbcu2ydktRHTi95PEL2ffHQ,1721
 osbot_utils/helpers/sqlite/tables/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/ssh/SCP.py,sha256=9PgJbyWKfxJj00Ijaj7o6ffxPXuNoureb6JlHMPbHww,3330
+osbot_utils/helpers/ssh/SCP.py,sha256=pMrb0S3xTFNrJsGLlTe6OnvAWVXiXgVv3Q5VWs_J52I,3396
 osbot_utils/helpers/ssh/SSH.py,sha256=KPmIewh-ucGqubrwZoZILhX60MCV9UEw8do8JKrZ91s,1542
 osbot_utils/helpers/ssh/SSH__Cache__Requests.py,sha256=Dqh4biVcuaXbQVvn3Tx-kSGBGHiF-2wVsgu96EhD6gU,3359
-osbot_utils/helpers/ssh/SSH__Execute.py,sha256=xmJe7JySTX2TG9TuL_fGFDkz91Yz1TL6ntubE1Myh5Q,6966
+osbot_utils/helpers/ssh/SSH__Execute.py,sha256=Z0W-cgVxwwSwVTBCrycRe6kyTPz19AgpcWmPVxbAO_w,7090
 osbot_utils/helpers/ssh/SSH__Health_Check.py,sha256=WDmBD6ejNcBeicXfjpsiNzH-WR3Jejx0re3WfwjSWyQ,2083
 osbot_utils/helpers/ssh/SSH__Linux.py,sha256=O1uyKcklaj2tHqQZln7dVinzjl9-EI52KzP8ojQr244,4330
 osbot_utils/helpers/ssh/SSH__Linux__Amazon.py,sha256=ZJFb7LFTvclAuhH5OoOtJ361NoX9ecHTaFX-iSmnzmk,596
@@ -269,8 +280,7 @@ osbot_utils/helpers/xml/rss/RSS__Image.py,sha256=13k8K03VTZbP0efeDL07oZF7Lg0CQcc
 osbot_utils/helpers/xml/rss/RSS__Item.py,sha256=K6YF3EVUu6E-_ISke98QXgnJlfOI5YAIO4pBzUZq7gE,608
 osbot_utils/testing/Catch.py,sha256=HdNoKnrPBjvVj87XYN-Wa1zpo5z3oByURT6TKbd5QpQ,2229
 osbot_utils/testing/Custom_Handler_For_Http_Tests.py,sha256=LKscFEcuwTQQ9xl4q71PR5FA8U-q8OtfTkCJoIgQIoQ,5358
-osbot_utils/testing/Duration.py,sha256=iBrczAuw6j3jXtG7ZPraT0PXbCILEcCplJbqei96deA,2217
-osbot_utils/testing/Hook_Method.py,sha256=uCpc89ZhMCfWiyt3tFhIGIInXiY6wTuwAZ1I8UQVRuw,4365
+osbot_utils/testing/Hook_Method.py,sha256=QoxdbxnVLa4-VYrMCMmo66BoR6nR2BP0Q15asaJXacs,4405
 osbot_utils/testing/Log_To_Queue.py,sha256=pZQ7I1ne-H365a4WLS60oAD-B16pxIZO4suvCdaTW8U,1703
 osbot_utils/testing/Log_To_String.py,sha256=hkjWsJfV68uqgX9nvVqUN3mVPxZQDb-6UBwsSEbQnkA,1216
 osbot_utils/testing/Logging.py,sha256=rzO1cCwty1oTucbV1q6U2QBIF87oOcvZoAY_R8SQB8A,3300
@@ -313,13 +323,13 @@ osbot_utils/type_safe/shared/Type_Safe__Json_Compressor.py,sha256=TDbot_NNzCPXBQ
 osbot_utils/type_safe/shared/Type_Safe__Json_Compressor__Type_Registry.py,sha256=wYOCg7F1nTrRn8HlnZvrs_8A8WL4gxRYRLnXZpGIiuk,1119
 osbot_utils/type_safe/shared/Type_Safe__Not_Cached.py,sha256=25FAl6SOLxdStco_rm9tgOYLfuKyBWheGdl7vVa56UU,800
 osbot_utils/type_safe/shared/Type_Safe__Raise_Exception.py,sha256=pbru8k8CTQMNUfmFBndiJhg2KkqEYzFvJAPcNZHeHfQ,829
-osbot_utils/type_safe/shared/Type_Safe__Shared__Variables.py,sha256=SuZGl9LryQX6IpOE0I_lbzClT-h17UNylC__-M8ltTY,129
+osbot_utils/type_safe/shared/Type_Safe__Shared__Variables.py,sha256=A2ztu-9EYjkzrW2NqCl7cdr2ivVl0n9nZXCZHWfl8W4,302
 osbot_utils/type_safe/shared/Type_Safe__Validation.py,sha256=1oamgApW2Pug0vvTqMLPxBLFvtcnp1bFnjSUByfJBrs,19192
 osbot_utils/type_safe/shared/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/type_safe/steps/Type_Safe__Step__Class_Kwargs.py,sha256=snoyJKvZ1crgF2fp0zexwNPnV_E63RfyRIsMAZdrKNY,6995
 osbot_utils/type_safe/steps/Type_Safe__Step__Default_Kwargs.py,sha256=tzKXDUc0HVP5QvCWsmcPuuZodNvQZ9FeMDNI2x00Ngw,1943
 osbot_utils/type_safe/steps/Type_Safe__Step__Default_Value.py,sha256=K_tkVQyLUbbWYzDnzoPLCgDBAFYyUjAG4VdLsvjzL1g,4485
-osbot_utils/type_safe/steps/Type_Safe__Step__From_Json.py,sha256=Be3hZhmQCDKqRBERPfopeDH-re6fyOXM8lRkx5Ndzb8,12757
+osbot_utils/type_safe/steps/Type_Safe__Step__From_Json.py,sha256=mf0HvluDy-TgNiQy-SCdZcG2v3MXP7GHhmsrgyq8WfM,13043
 osbot_utils/type_safe/steps/Type_Safe__Step__Init.py,sha256=v4FD7zxQiOFLiOF1Ma8wZMP8aLgRlXwJZnsIfBu2zeg,1266
 osbot_utils/type_safe/steps/Type_Safe__Step__Set_Attr.py,sha256=VuKHH9QEYlbAL9R4zwQ5dwexx2sFY6wMx52QmF7eqcg,5219
 osbot_utils/type_safe/steps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -355,8 +365,8 @@ osbot_utils/utils/Toml.py,sha256=Rxl8gx7mni5CvBAK-Ai02EKw-GwtJdd3yeHT2kMloik,166
 osbot_utils/utils/Version.py,sha256=Ww6ChwTxqp1QAcxOnztkTicShlcx6fbNsWX5xausHrg,422
 osbot_utils/utils/Zip.py,sha256=pR6sKliUY0KZXmqNzKY2frfW-YVQEVbLKiyqQX_lc-8,14052
 osbot_utils/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/version,sha256=ON8CcGgOzXQTBlj0GoLWU4kJJ4NSmn3tfF8hCE1vYZ4,8
-osbot_utils-2.29.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-osbot_utils-2.29.0.dist-info/METADATA,sha256=bP7-jWt9xctBc_Fa8lXhfnqxaWkMYRCAK6zwNCxx_Sg,1329
-osbot_utils-2.29.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-osbot_utils-2.29.0.dist-info/RECORD,,
+osbot_utils/version,sha256=HCRke6XnsWX14IEkvcnr363MBi6BbkbVDkvEZXWN1Dg,8
+osbot_utils-2.31.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+osbot_utils-2.31.0.dist-info/METADATA,sha256=cA1LigYUC3D4O8kl4ofRRahn_BQ0MwTtvIIbPSSwf3k,1329
+osbot_utils-2.31.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+osbot_utils-2.31.0.dist-info/RECORD,,