osbot-utils 1.95.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

osbot_utils/base_classes/Kwargs_To_Self.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 # todo: refactor all of Kwargs_To_Self to use Type_Safe
 Kwargs_To_Self = Type_Safe

osbot_utils/context_managers/capture_duration.py

@@ -1,5 +1,5 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
-from osbot_utils.utils.Misc import timestamp_utc_now
+from osbot_utils.type_safe.Type_Safe import Type_Safe
+from osbot_utils.utils.Misc          import timestamp_utc_now
 
 
 class capture_duration(Type_Safe):

osbot_utils/decorators/methods/type_safe.py

@@ -1,5 +1,5 @@
 import functools                                                                           # For wrapping functions
-from osbot_utils.helpers.Type_Safe_Method import Type_Safe_Method
+from osbot_utils.type_safe.Type_Safe_Method import Type_Safe_Method
 
 def type_safe(func):                                                                       # Main decorator function
     @functools.wraps(func)                                                                 # Preserve function metadata

osbot_utils/helpers/CFormat.py

@@ -2,7 +2,7 @@
 #     - Have code complete on CPrint
 #     - not have the write the code for each of the methods
 #     - have a good and logical place to capture the ID of the color
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 
 class CFormat_Colors:

osbot_utils/helpers/Hashicorp_Secrets.py

@@ -1,5 +1,5 @@
 from osbot_utils.utils.Env                  import get_env
-from osbot_utils.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.utils.Lists                import list_index_by
 from osbot_utils.utils.Misc                 import list_set
 

osbot_utils/helpers/Zip_Bytes.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.utils.Dev                  import pprint
 from osbot_utils.utils.Files                import files_list, file_create_from_bytes, temp_file, parent_folder, parent_folder_create
 from osbot_utils.utils.Misc                 import random_text

osbot_utils/helpers/cache_requests/Cache__Requests__Actions.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe                             import Type_Safe
+from osbot_utils.type_safe.Type_Safe                             import Type_Safe
 from osbot_utils.helpers.cache_requests.Cache__Requests__Row        import Cache__Requests__Row
 from osbot_utils.helpers.cache_requests.Cache__Requests__Table      import Cache__Requests__Table
 from osbot_utils.utils.Json                                         import json_dumps

osbot_utils/helpers/cache_requests/Cache__Requests__Config.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 
 class Cache__Requests__Config(Type_Safe):

osbot_utils/helpers/cache_requests/Cache__Requests__Data.py

@@ -1,5 +1,5 @@
 import types
-from osbot_utils.base_classes.Type_Safe                                     import Type_Safe
+from osbot_utils.type_safe.Type_Safe                                     import Type_Safe
 from osbot_utils.helpers.cache_requests.Cache__Requests__Config             import Cache__Requests__Config
 from osbot_utils.helpers.cache_requests.Cache__Requests__Table              import Cache__Requests__Table
 from osbot_utils.utils.Json                                                 import json_dumps, json_loads

osbot_utils/helpers/cache_requests/Cache__Requests__Invoke.py

@@ -1,7 +1,7 @@
 import threading
 import types
 
-from osbot_utils.base_classes.Type_Safe                                 import Type_Safe
+from osbot_utils.type_safe.Type_Safe                                 import Type_Safe
 from osbot_utils.helpers.cache_requests.Cache__Requests__Actions        import Cache__Requests__Actions
 from osbot_utils.helpers.cache_requests.Cache__Requests__Config         import Cache__Requests__Config
 from osbot_utils.helpers.cache_requests.Cache__Requests__Data           import Cache__Requests__Data

osbot_utils/helpers/cache_requests/Cache__Requests__Row.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe                         import Type_Safe
+from osbot_utils.type_safe.Type_Safe                         import Type_Safe
 from osbot_utils.helpers.cache_requests.Cache__Requests__Config import Cache__Requests__Config
 from osbot_utils.helpers.cache_requests.Cache__Requests__Table  import Cache__Requests__Table
 from osbot_utils.utils.Json                                     import json_dumps

osbot_utils/helpers/cache_requests/Cache__Requests__Table.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 
 class Cache__Requests__Table(Type_Safe):

osbot_utils/helpers/flows/Flow.py

@@ -3,7 +3,7 @@ import logging
 import typing
 
 from osbot_utils.helpers.Dependency_Manager             import Dependency_Manager
-from osbot_utils.base_classes.Type_Safe                 import Type_Safe
+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.Flow__Events             import flow_events

osbot_utils/helpers/flows/Flow__Events.py

@@ -1,6 +1,6 @@
 from osbot_utils.helpers.flows.models.Flow_Run__Event_Data import Flow_Run__Event_Data
 from osbot_utils.utils.Str                                  import ansi_to_text
-from osbot_utils.base_classes.Type_Safe                     import Type_Safe
+from osbot_utils.type_safe.Type_Safe                     import Type_Safe
 from osbot_utils.helpers.flows.models.Flow_Run__Event       import Flow_Run__Event
 from osbot_utils.helpers.flows.models.Flow_Run__Event_Type  import Flow_Run__Event_Type
 

osbot_utils/helpers/flows/Task.py

@@ -8,7 +8,7 @@ from osbot_utils.helpers.Dependency_Manager import Dependency_Manager
 from osbot_utils.helpers.flows.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.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.helpers.flows.Flow         import Flow
 
 TASK__RANDOM_ID__PREFIX    = 'task_id__'

osbot_utils/helpers/flows/models/Flow_Run__Config.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 
 class Flow_Run__Config(Type_Safe):

osbot_utils/helpers/flows/models/Flow_Run__Event.py

@@ -1,6 +1,6 @@
 from osbot_utils.helpers.Random_Guid import Random_Guid
 
-from osbot_utils.base_classes.Type_Safe                     import Type_Safe
+from osbot_utils.type_safe.Type_Safe                     import Type_Safe
 from osbot_utils.helpers.Timestamp_Now                      import Timestamp_Now
 from osbot_utils.helpers.flows.models.Flow_Run__Event_Data  import Flow_Run__Event_Data
 from osbot_utils.helpers.flows.models.Flow_Run__Event_Type  import Flow_Run__Event_Type

osbot_utils/helpers/flows/models/Flow_Run__Event_Data.py

@@ -1,6 +1,6 @@
 import logging
 
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 
 class Flow_Run__Event_Data(Type_Safe):

osbot_utils/helpers/flows/models/Flow_Run__Event_Type.py

@@ -1,6 +1,6 @@
 from enum import Enum
 
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 class Flow_Run__Event_Type(Enum):
     FLOW_MESSAGE: str = 'flow_message'

osbot_utils/helpers/generators/Generator_Manager.py

@@ -3,7 +3,7 @@ from _thread                                                    import RLock
 from types                                                      import GeneratorType
 from typing                                                     import Dict                               # Typing imports for type hints
 from typing                                                     import Union
-from osbot_utils.base_classes.Type_Safe                         import Type_Safe                          # Type_Safe base class for type-safe attributes
+from osbot_utils.type_safe.Type_Safe                         import Type_Safe                          # Type_Safe base class for type-safe attributes
 from osbot_utils.helpers.Random_Guid                            import Random_Guid                        # Helper for generating unique IDs
 from osbot_utils.helpers.generators.Generator_Context_Manager   import Generator_Context_Manager
 from osbot_utils.helpers.generators.Model__Generator_State      import Model__Generator_State

osbot_utils/helpers/generators/Model__Generator_Target.py

@@ -1,5 +1,5 @@
 from types                                                  import GeneratorType
-from osbot_utils.base_classes.Type_Safe                     import Type_Safe
+from osbot_utils.type_safe.Type_Safe                     import Type_Safe
 from osbot_utils.helpers.Random_Guid                        import Random_Guid
 from osbot_utils.helpers.generators.Model__Generator_State  import Model__Generator_State
 

osbot_utils/helpers/pubsub/Event__Queue.py

@@ -1,7 +1,7 @@
 import time
 from queue                                                      import Queue, Empty
 from threading                                                  import Thread
-from osbot_utils.base_classes.Type_Safe                         import Type_Safe
+from osbot_utils.type_safe.Type_Safe                         import Type_Safe
 from osbot_utils.helpers.pubsub.schemas.Schema__Event           import Schema__Event
 from osbot_utils.helpers.pubsub.schemas.Schema__Event__Message  import Schema__Event__Message
 from osbot_utils.utils.Misc                                     import random_text, timestamp_utc_now, random_guid

osbot_utils/helpers/sqlite/Sqlite__Database.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe             import Type_Safe
+from osbot_utils.type_safe.Type_Safe             import Type_Safe
 from osbot_utils.decorators.methods.cache_on_self   import cache_on_self
 from osbot_utils.utils.Files                        import current_temp_folder, path_combine, folder_create, file_exists, file_delete
 from osbot_utils.utils.Misc                         import  random_filename

osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests.py

@@ -1,5 +1,5 @@
 import types
-from osbot_utils.base_classes.Type_Safe                                     import Type_Safe
+from osbot_utils.type_safe.Type_Safe                                     import Type_Safe
 from osbot_utils.helpers.cache_requests.Cache__Requests__Actions            import Cache__Requests__Actions
 from osbot_utils.helpers.cache_requests.Cache__Requests__Config             import Cache__Requests__Config
 from osbot_utils.helpers.cache_requests.Cache__Requests__Data               import Cache__Requests__Data

osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests__Sqlite.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe                         import Type_Safe
+from osbot_utils.type_safe.Type_Safe                         import Type_Safe
 from osbot_utils.helpers.cache_requests.Cache__Requests__Config import Cache__Requests__Config
 from osbot_utils.helpers.sqlite.cache.Sqlite__DB__Requests      import Sqlite__DB__Requests
 

osbot_utils/helpers/ssh/SSH.py

@@ -1,5 +1,5 @@
 from osbot_utils.base_classes.Kwargs_To_Self        import Kwargs_To_Self
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 from osbot_utils.decorators.methods.cache_on_self   import cache_on_self
 from osbot_utils.helpers.ssh.SCP                    import SCP
 from osbot_utils.helpers.ssh.SSH__Execute           import SSH__Execute

osbot_utils/helpers/ssh/SSH__Execute.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+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

osbot_utils/helpers/ssh/SSH__Python.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 from osbot_utils.helpers.ssh.SSH__Execute import SSH__Execute
 from osbot_utils.helpers.ssh.SSH__Linux import SSH__Linux
 from osbot_utils.utils.Dev import pprint

osbot_utils/helpers/trace/Trace_Call__Config.py

@@ -1,5 +1,5 @@
 
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 from osbot_utils.utils.Dev              import pprint                   # todo: fix test requirement of mock to use this method
 
 

osbot_utils/helpers/xml/Xml__Attribute.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 
 class Xml__Attribute(Type_Safe):

osbot_utils/helpers/xml/Xml__Element.py

@@ -1,5 +1,5 @@
 from typing                                 import Dict, List, Union
-from osbot_utils.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.helpers.xml.Xml__Attribute import Xml__Attribute
 
 class XML__Element(Type_Safe):

osbot_utils/helpers/xml/Xml__File.py

@@ -1,5 +1,5 @@
 from typing                                 import Dict
-from osbot_utils.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.helpers.xml.Xml__Element   import XML__Element
 
 class Xml__File(Type_Safe):

osbot_utils/helpers/xml/Xml__File__Load.py

@@ -1,7 +1,7 @@
 from io                                     import StringIO
 from typing                                 import List, Union, Dict
 from xml.etree.ElementTree                  import iterparse, Element, fromstring, ParseError
-from osbot_utils.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.helpers.xml.Xml__Attribute import Xml__Attribute
 from osbot_utils.helpers.xml.Xml__Element   import XML__Element
 from osbot_utils.helpers.xml.Xml__File      import Xml__File

osbot_utils/helpers/xml/Xml__File__To_Dict.py

@@ -1,5 +1,5 @@
 from typing                                 import Dict, Any
-from osbot_utils.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.helpers.xml.Xml__Element   import XML__Element
 from osbot_utils.helpers.xml.Xml__File      import Xml__File
 

osbot_utils/helpers/xml/Xml__File__To_Xml.py

@@ -1,7 +1,7 @@
 from typing                                 import Optional
 from xml.etree.ElementTree                  import Element, SubElement, tostring
 from xml.dom                                import minidom
-from osbot_utils.base_classes.Type_Safe     import Type_Safe
+from osbot_utils.type_safe.Type_Safe     import Type_Safe
 from osbot_utils.helpers.xml.Xml__Element   import XML__Element
 from osbot_utils.helpers.xml.Xml__File      import Xml__File
 

osbot_utils/helpers/xml/rss/RSS__Channel.py

@@ -1,5 +1,5 @@
 from typing                                     import Any, Dict, List
-from osbot_utils.base_classes.Type_Safe         import Type_Safe
+from osbot_utils.type_safe.Type_Safe         import Type_Safe
 from osbot_utils.helpers.xml.rss.RSS__Image     import RSS__Image
 from osbot_utils.helpers.xml.rss.RSS__Item      import RSS__Item
 

osbot_utils/helpers/xml/rss/RSS__Enclosure.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 
 class RSS__Enclosure(Type_Safe):

osbot_utils/helpers/xml/rss/RSS__Feed.py

@@ -1,5 +1,5 @@
 from typing                                     import Dict, Any
-from osbot_utils.base_classes.Type_Safe         import Type_Safe
+from osbot_utils.type_safe.Type_Safe         import Type_Safe
 from osbot_utils.helpers.xml.rss.RSS__Channel   import RSS__Channel
 
 DEFAULT__RSS_FEED__VERSION = "2.0"

osbot_utils/helpers/xml/rss/RSS__Image.py

@@ -1,4 +1,4 @@
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 class RSS__Image(Type_Safe):
     url    : str

osbot_utils/helpers/xml/rss/RSS__Item.py

@@ -1,5 +1,5 @@
 from typing                                         import Dict, List, Any
-from osbot_utils.base_classes.Type_Safe             import Type_Safe
+from osbot_utils.type_safe.Type_Safe             import Type_Safe
 from osbot_utils.helpers.Guid                       import Guid
 from osbot_utils.helpers.xml.rss.RSS__Enclosure     import RSS__Enclosure
 

osbot_utils/testing/Temp_Env_Vars.py

@@ -1,5 +1,5 @@
 import os
-from osbot_utils.base_classes.Type_Safe import Type_Safe
+from osbot_utils.type_safe.Type_Safe import Type_Safe
 from osbot_utils.utils.Env              import del_env, set_env
 
 

osbot_utils/{base_classes → type_safe}/Type_Safe.py

@@ -84,11 +84,11 @@ class Type_Safe:
         raise AttributeError(f"'{type(self).__name__}' object has no attribute '{name}'")   # Raise error if attribute is not a valid getter/setter
 
     def __setattr__(self, name, value):
-        from osbot_utils.utils.Objects                          import convert_dict_to_value_from_obj_annotation
-        from osbot_utils.utils.Objects                          import convert_to_value_from_obj_annotation
-        from osbot_utils.utils.Objects                          import value_type_matches_obj_annotation_for_attr
-        from osbot_utils.utils.Objects                          import value_type_matches_obj_annotation_for_union_and_annotated
-        from osbot_utils.helpers.type_safe.Type_Safe__Validator import Type_Safe__Validator
+        from osbot_utils.utils.Objects                  import convert_dict_to_value_from_obj_annotation
+        from osbot_utils.utils.Objects                  import convert_to_value_from_obj_annotation
+        from osbot_utils.utils.Objects                  import value_type_matches_obj_annotation_for_attr
+        from osbot_utils.utils.Objects                  import value_type_matches_obj_annotation_for_union_and_annotated
+        from osbot_utils.type_safe.Type_Safe__Validator import Type_Safe__Validator
 
         annotations = all_annotations(self)
         if not annotations:                                             # can't do type safety checks if the class does not have annotations
@@ -184,8 +184,8 @@ class Type_Safe:
     @classmethod
     def __default__value__(cls, var_type):
         import typing
-        from osbot_utils.base_classes.Type_Safe__List import Type_Safe__List
-        from osbot_utils.base_classes.Type_Safe__Dict import Type_Safe__Dict
+        from osbot_utils.type_safe.Type_Safe__List import Type_Safe__List
+        from osbot_utils.type_safe.Type_Safe__Dict import Type_Safe__Dict
 
         if var_type is typing.Set:                              # todo: refactor the dict, set and list logic, since they are 90% the same
             return set()
@@ -324,7 +324,7 @@ class Type_Safe:
         return value
 
     def deserialize_dict__using_key_value_annotations(self, key, value):
-        from osbot_utils.base_classes.Type_Safe__Dict import Type_Safe__Dict
+        from osbot_utils.type_safe.Type_Safe__Dict import Type_Safe__Dict
 
         dict_annotations_tuple =  get_args(self.__annotations__[key])
         if not dict_annotations_tuple:                                      # happens when the value is a dict/Dict with no annotations
@@ -353,7 +353,7 @@ class Type_Safe:
     def deserialize_from_dict(self, data, raise_on_not_found=False):
         from decimal                                    import Decimal
         from enum                                       import EnumMeta
-        from osbot_utils.base_classes.Type_Safe__List   import Type_Safe__List
+        from osbot_utils.type_safe.Type_Safe__List   import Type_Safe__List
         from osbot_utils.helpers.Random_Guid            import Random_Guid
         from osbot_utils.helpers.Random_Guid_Short      import Random_Guid_Short
         from osbot_utils.utils.Objects                  import obj_is_attribute_annotation_of_type

osbot_utils/{base_classes → type_safe}/Type_Safe__Base.py

@@ -85,6 +85,9 @@ class Type_Safe__Base:
                 actual_type_name = type_str(type(item))
                 raise TypeError(f"Expected '{expected_type_name}', but got '{actual_type_name}'")
 
+    def json(self):
+        raise NotImplemented
+
 # todo: see if we should/can move this to the Objects.py file
 def type_str(tp):
     origin = get_origin(tp)

osbot_utils/type_safe/Type_Safe__Dict.py

@@ -0,0 +1,39 @@
+from osbot_utils.type_safe.Type_Safe__Base import type_str, Type_Safe__Base
+
+class Type_Safe__Dict(Type_Safe__Base, dict):
+    def __init__(self, expected_key_type, expected_value_type, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        self.expected_key_type   = expected_key_type
+        self.expected_value_type = expected_value_type
+
+        for k, v in self.items():                           # check type-safety of ctor arguments
+            self.is_instance_of_type(k, self.expected_key_type  )
+            self.is_instance_of_type(v, self.expected_value_type)
+
+    def __setitem__(self, key, value):                                  # Check type-safety before allowing assignment.
+        self.is_instance_of_type(key, self.expected_key_type)
+        self.is_instance_of_type(value, self.expected_value_type)
+        super().__setitem__(key, value)
+
+    def __repr__(self):
+        key_type_name   = type_str(self.expected_key_type)
+        value_type_name = type_str(self.expected_value_type)
+        return f"dict[{key_type_name}, {value_type_name}] with {len(self)} entries"
+
+    def json(self):                                                                         # Convert the dictionary to a JSON-serializable format.
+        from osbot_utils.type_safe.Type_Safe import Type_Safe                               # can only import this here to avoid circular imports
+
+        result = {}
+        for key, value in self.items():
+            if isinstance(value, Type_Safe):                                                # Handle Type_Safe objects in values
+                result[key] = value.json()
+            elif isinstance(value, (list, tuple)):                                          # Handle lists/tuples that might contain Type_Safe objects
+                result[key] = [item.json() if isinstance(item, Type_Safe) else item
+                               for item in value]
+            elif isinstance(value, dict):                                                   # Handle nested dictionaries that might contain Type_Safe objects
+                result[key] = {k: v.json() if isinstance(v, Type_Safe) else v
+                               for k, v in value.items()}
+            else:                                                                           # Regular values can be used as-is
+                result[key] = value
+        return result

osbot_utils/type_safe/Type_Safe__List.py

@@ -0,0 +1,34 @@
+from osbot_utils.type_safe.Type_Safe__Base import Type_Safe__Base, type_str
+
+class Type_Safe__List(Type_Safe__Base, list):
+
+    def __init__(self, expected_type, *args):
+        super().__init__(*args)
+        self.expected_type = expected_type
+
+    def __repr__(self):
+        expected_type_name = type_str(self.expected_type)
+        return f"list[{expected_type_name}] with {len(self)} elements"
+
+    def append(self, item):
+        try:
+            self.is_instance_of_type(item, self.expected_type)
+        except TypeError as e:
+            raise TypeError(f"In Type_Safe__List: Invalid type for item: {e}")
+        super().append(item)
+
+
+    def json(self): # Convert the list to a JSON-serializable format.
+        from osbot_utils.type_safe.Type_Safe import Type_Safe                           # Import here to avoid circular imports
+
+        result = []
+        for item in self:
+            if isinstance(item, Type_Safe):
+                result.append(item.json())
+            elif isinstance(item, (list, tuple)):
+                result.append([x.json() if isinstance(x, Type_Safe) else x for x in item])
+            elif isinstance(item, dict):
+                result.append({k: v.json() if isinstance(v, Type_Safe) else v for k, v in item.items()})
+            else:
+                result.append(item)
+        return result

osbot_utils/{helpers/type_safe → type_safe}/validators/Validator__Max.py

@@ -1,5 +1,5 @@
 from typing                                             import Any
-from osbot_utils.helpers.type_safe.Type_Safe__Validator import Type_Safe__Validator
+from osbot_utils.type_safe.Type_Safe__Validator import Type_Safe__Validator
 
 
 class Validator__Max(Type_Safe__Validator):                             #    Validates that a numeric value is at most the specified maximum."""

osbot_utils/{helpers/type_safe → type_safe}/validators/Validator__Min.py

@@ -1,5 +1,5 @@
 from typing                                             import Any
-from osbot_utils.helpers.type_safe.Type_Safe__Validator import Type_Safe__Validator
+from osbot_utils.type_safe.Type_Safe__Validator import Type_Safe__Validator
 
 class Validator__Min(Type_Safe__Validator):                     # Validates that a value is at least the specified minimum. Works with any type that supports the < operator (numbers, strings, lists, etc.)
     min_value: Any

osbot_utils/{helpers/type_safe → type_safe}/validators/Validator__One_Of.py

@@ -1,5 +1,5 @@
 from typing                                             import Any
-from osbot_utils.helpers.type_safe.Type_Safe__Validator import Type_Safe__Validator
+from osbot_utils.type_safe.Type_Safe__Validator import Type_Safe__Validator
 
 
 class Validator__One_Of(Type_Safe__Validator):                  # Validates that a value is one of a set of allowed values."""

osbot_utils/{helpers/type_safe → type_safe}/validators/Validator__Regex.py

@@ -1,5 +1,5 @@
 from typing                                             import Any
-from osbot_utils.helpers.type_safe.Type_Safe__Validator import Type_Safe__Validator
+from osbot_utils.type_safe.Type_Safe__Validator import Type_Safe__Validator
 
 class Validator__Regex(Type_Safe__Validator):            # Validates that a string matches the specified regex pattern.
     pattern    : str

osbot_utils/utils/Python_Logger.py

@@ -4,10 +4,10 @@ import sys
 import types
 from logging                                                import Logger, StreamHandler, FileHandler
 from logging.handlers                                       import MemoryHandler
-from osbot_utils.base_classes.Type_Safe                     import Type_Safe
 from osbot_utils.decorators.lists.group_by                  import group_by
 from osbot_utils.decorators.lists.index_by                  import index_by
 from osbot_utils.decorators.methods.cache_on_function       import cache_on_function
+from osbot_utils.type_safe.Type_Safe                        import Type_Safe
 from osbot_utils.utils.Misc                                 import random_string
 from osbot_utils.utils.Files                                import temp_file
 from osbot_utils.utils.Objects                              import obj_dict

osbot_utils/version

@@ -1 +1 @@
-v1.95.0
+v2.1.0

{osbot_utils-1.95.0.dist-info → osbot_utils-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: osbot_utils
-Version: 1.95.0
+Version: 2.1.0
 Summary: OWASP Security Bot - Utils
 Home-page: https://github.com/owasp-sbot/OSBot-Utils
 License: MIT
@@ -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-v1.95.0-blue)
+![Current Release](https://img.shields.io/badge/release-v2.1.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-1.95.0.dist-info → osbot_utils-2.1.0.dist-info}/RECORD

@@ -1,15 +1,11 @@
 osbot_utils/__init__.py,sha256=DdJDmQc9zbQUlPVyTJOww6Ixrn9n4bD3ami5ItQfzJI,16
 osbot_utils/base_classes/Cache_Pickle.py,sha256=kPCwrgUbf_dEdxUz7vW1GuvIPwlNXxuRhb-H3AbSpII,5884
 osbot_utils/base_classes/Kwargs_To_Disk.py,sha256=HHoy05NC_w35WcT-OnSKoSIV_cLqaU9rdjH0_KNTM0E,1096
-osbot_utils/base_classes/Kwargs_To_Self.py,sha256=weFNsBfBNV9W_qBkN-IdBD4yYcJV_zgTxBRO-ZlcPS4,141
-osbot_utils/base_classes/Type_Safe.py,sha256=cfpLk3x0TQNeRMSRda91_DAO_m14_QtYcRrGMWZ8dmU,29076
-osbot_utils/base_classes/Type_Safe__Base.py,sha256=CFPYe8_i5vvTLyc7s8CXbY4n_dY6sqVfBY8w9Vo77ZA,5468
-osbot_utils/base_classes/Type_Safe__Dict.py,sha256=yB9dSNPh_PARqXhNLg1HBFXgMsB-o-PC7h-BUE8njg0,1106
-osbot_utils/base_classes/Type_Safe__List.py,sha256=pXDzJJttpEQQ9oTdsw7BykMB4VIX2rZzi1ZrnCzMZ8M,650
+osbot_utils/base_classes/Kwargs_To_Self.py,sha256=3LRFpxdg9RBuUlIacF1Bwq014NXtJmB4U2dy9a69uY8,138
 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=EhQUPHK_zjpm9dsnEhkJRrcd0fdngPgsM1QlNjquWwI,1147
+osbot_utils/context_managers/capture_duration.py,sha256=Bqbak6iGgUvBoLpxPDvnXgUCtbGeuY93wI_2GC415lU,1153
 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
@@ -33,16 +29,16 @@ osbot_utils/decorators/methods/function_type_check.py,sha256=o8Je6k-tXd3UmbgVL0g
 osbot_utils/decorators/methods/obj_as_context.py,sha256=59JgxUvEruh_4ROoWHXK22Jv8C4_E5mSxb4aG3JbL50,104
 osbot_utils/decorators/methods/remove_return_value.py,sha256=EerRwBFDJ3ICKA0BrNzelRECb3n2NUMoFzcn0rQyCUY,1162
 osbot_utils/decorators/methods/required_fields.py,sha256=PZd9LKd4qBeqxgP9FgTtLNNJ0coZx99hFJyNEKmF1K0,783
-osbot_utils/decorators/methods/type_safe.py,sha256=WtoDTRPcFV-EgSaNEawMj2plVq-zRlgR2tKPjGRgSqQ,1001
+osbot_utils/decorators/methods/type_safe.py,sha256=yK1td-9WHFj2pe4dvBtw1cjYOE6z6-VnG5DCStGCO1c,1003
 osbot_utils/fluent/Fluent_Dict.py,sha256=nZ2z91s39sU2a-TLYpBirRoWgDXHrs0tQ9Bi_ZdKeW0,481
 osbot_utils/fluent/Fluent_List.py,sha256=PfDDC9sm16CFnNQ8gkhCEsmKcZp8iyQ0YBpSHvYssG8,1089
 osbot_utils/fluent/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-osbot_utils/helpers/CFormat.py,sha256=1_XvqGwgU6qC97MbzcKF0o7s9mCXpU5Kq9Yf-1ixUwY,6808
+osbot_utils/helpers/CFormat.py,sha256=QviXlx3cQF7Wq6bNQmvWPHknDDMQXg5bh5dsRncrg-U,6805
 osbot_utils/helpers/CPrint.py,sha256=ztKPNmT8BGxeyPXSQKRs63PqqbgxKDz_BiZmzFMup9g,1413
 osbot_utils/helpers/Dependency_Manager.py,sha256=79YRYnVfchewq8iSMJ5dzwW2D5u8chWcIqYE-G9YrSo,1337
 osbot_utils/helpers/Dict_To_Attr.py,sha256=NdhXl5mJH7-NaBk213amzc5Nfy3tJgW-N_uYIRE4hoc,208
 osbot_utils/helpers/Guid.py,sha256=fqiCYHrYff3yZ_Df-WJdXHl1RQtJHb4oCmDkJpcGN_k,828
-osbot_utils/helpers/Hashicorp_Secrets.py,sha256=zjXa_dQvfR9L1uoulWJ8nYYaDvznV6o_QPPS4zmb6mo,4235
+osbot_utils/helpers/Hashicorp_Secrets.py,sha256=e2fWWHK6bubpAm1sw5y8X5kh2Hk5d4JyZCnUovZip5A,4232
 osbot_utils/helpers/Local_Cache.py,sha256=0JZZX3fFImcwtbBvxAQl-EbBegSNJRhRMYF6ovTH6zY,3141
 osbot_utils/helpers/Local_Caches.py,sha256=aQmi1HSM0TH6WQPedG2fbz4KCCJ3DQTU9d18rB1jR0M,1885
 osbot_utils/helpers/Print_Table.py,sha256=LEXbyqGg_6WSraI4cob4bNNSu18ddqvALp1zGK7bPhs,19126
@@ -54,8 +50,7 @@ osbot_utils/helpers/Safe_Id.py,sha256=0wPGd9eLzaOCYTSg9yEOal1kPsc8OI9khHkqEw9VQO
 osbot_utils/helpers/Str_ASCII.py,sha256=PRqyu449XnKrLn6b9Miii1Hv-GO5OAa1UhhgvlRcC2M,704
 osbot_utils/helpers/Timestamp_Now.py,sha256=k3-SUGYx2jLTXvgZYeECqPRJhVxqWPmW7co1l6r12jk,438
 osbot_utils/helpers/Type_Registry.py,sha256=Ajk3SyMSKDi2g9SJYUtTgg7PZkAgydaHcpbGuEN3S94,311
-osbot_utils/helpers/Type_Safe_Method.py,sha256=8E88of__An9_ZhJKz6Kp22C1mb9WLED0jWNLOII3fJs,10489
-osbot_utils/helpers/Zip_Bytes.py,sha256=6i6uD1TIcMZZRM8BYMseSnihRxUI2vJiai3UnPHrGrY,4290
+osbot_utils/helpers/Zip_Bytes.py,sha256=Bf17NPS_yxrzI_4FsCxkjlhS9ELJK3kisY-jHQPQVgw,4287
 osbot_utils/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/ast/Ast.py,sha256=lcPQOSxXI6zgmMnIVF9WM6ISqViWX-sq4d_UC0CDG8s,1155
 osbot_utils/helpers/ast/Ast_Base.py,sha256=5rHMupBlN_n6lOC31UnSW_lWqxqxaE31v0gn-t32OgQ,3708
@@ -133,30 +128,30 @@ osbot_utils/helpers/ast/nodes/Ast_With.py,sha256=MO3doSFTxQEXUm8t4wDG5hFfWa_ByOM
 osbot_utils/helpers/ast/nodes/Ast_With_Item.py,sha256=ger_t7_sEb2HiHpFwXBRAUJTCgXBfKZyv2uGuHMnQqA,260
 osbot_utils/helpers/ast/nodes/Ast_Yield.py,sha256=7ATJnOHekV9XquMTYYSJ6xqyDvgwFc596myKPpHLddk,197
 osbot_utils/helpers/ast/nodes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/cache_requests/Cache__Requests__Actions.py,sha256=r1CMR4qHO9is66lexJQ-BNUmBWcEjOSTG_qC0xsoorY,1228
-osbot_utils/helpers/cache_requests/Cache__Requests__Config.py,sha256=KxBjj56YTjZjKsO9TLsRfkcHYJPIGDXZ6rFskaNnh-4,935
-osbot_utils/helpers/cache_requests/Cache__Requests__Data.py,sha256=W0t4HyRgTTBbykBf_Ui9o84xLPu5ivreB-jSdOct1lc,5504
-osbot_utils/helpers/cache_requests/Cache__Requests__Invoke.py,sha256=i8OiiA8afOnxVo_w9W8ySkMQygLAMMxDf3NAAmPCaE4,3348
-osbot_utils/helpers/cache_requests/Cache__Requests__Row.py,sha256=h-yc7NkpScbHwwf2km5wwKig-wLi4WuB9P4fVEdFGdM,3182
-osbot_utils/helpers/cache_requests/Cache__Requests__Table.py,sha256=RgxAYhm-FIrXXteQRtD91pOLq8JXhSzxb51Jb6MTUdY,391
+osbot_utils/helpers/cache_requests/Cache__Requests__Actions.py,sha256=PnCJdNltS8GGHSjmUMLF2u7zRT3Ym8M7DIT3n9LkJlw,1225
+osbot_utils/helpers/cache_requests/Cache__Requests__Config.py,sha256=cGjtPB-K_0Wk4bKbS26A3Rg2HAcBhWlMoZE0isBpRdc,932
+osbot_utils/helpers/cache_requests/Cache__Requests__Data.py,sha256=cWVViRSVbS_V7AYxSjR91Wg1UYPi--zbzGmnAZ6t8n0,5501
+osbot_utils/helpers/cache_requests/Cache__Requests__Invoke.py,sha256=q50s2Y6sGh33UcZjCSCi4ogHa49dsa39GW9gJY_Lvs8,3345
+osbot_utils/helpers/cache_requests/Cache__Requests__Row.py,sha256=Sb7E_zDB-LPlWI8TiPRF99BmX_RYA3cheyCCf3c3Dfo,3179
+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=oaNYmCxqYC8DxX7egZDVo7Id4pqqcRymKTTlDmy8pGs,10965
-osbot_utils/helpers/flows/Flow__Events.py,sha256=_BHXh9v1GfvTI7hGx7eJDkCGeo9VjqDoCTMDeL09Ujc,2843
-osbot_utils/helpers/flows/Task.py,sha256=3PiU1GCWhnDcgYxYRldo0CWcCcnQDvWvU2cXPCmpSTc,5336
+osbot_utils/helpers/flows/Flow.py,sha256=V4yVmnXB4oFwq3UtGF_7SPU5PmvNlowcQnqwAArP828,10962
+osbot_utils/helpers/flows/Flow__Events.py,sha256=g7KBafFeA7tV-v31v_m3MT__cZEX63gh8CehnZwRYU0,2840
+osbot_utils/helpers/flows/Task.py,sha256=tnO1q4nNnWYmcb66tMcKCOIgipAV-TCNO4xEtrnGDBc,5333
 osbot_utils/helpers/flows/__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
 osbot_utils/helpers/flows/decorators/task.py,sha256=9bhQBPJU1dO-J4FAsFkmxqQMBNtay4FT_b1BdpHJ9sA,734
-osbot_utils/helpers/flows/models/Flow_Run__Config.py,sha256=3JSPSG3vjM7mdnI-3wgLCc7Nc_3Xjqxn34_A6yUp-4Q,386
-osbot_utils/helpers/flows/models/Flow_Run__Event.py,sha256=-F_H_Tq119qa9tk8IoX5U36h_f8AE1VueL0olhjH24g,569
-osbot_utils/helpers/flows/models/Flow_Run__Event_Data.py,sha256=Xvv_vtOL-siSdt5nkRCLA7uHxlsA3bTm7ZD_EOkCVAU,405
-osbot_utils/helpers/flows/models/Flow_Run__Event_Type.py,sha256=-iHKNQ-Ar2UfiCraFYQNHdBQ9fNcTTRoh3kRpXRS_Gc,375
+osbot_utils/helpers/flows/models/Flow_Run__Config.py,sha256=hLBPEgoKjyBqAuIGEmnrv6giAnhYcKSz7dljmBwWRBY,383
+osbot_utils/helpers/flows/models/Flow_Run__Event.py,sha256=fEDjHDLSp5u6bRX4mbRJfGRmqVFN19pO5q0ADf6_KT4,566
+osbot_utils/helpers/flows/models/Flow_Run__Event_Data.py,sha256=3tUabRdPG6zrZQPEYAFtjpk_996TkXUB02YwFBlQq3o,402
+osbot_utils/helpers/flows/models/Flow_Run__Event_Type.py,sha256=y1GB6O_G6ZWCqjTyzyUhcjJSvhWC-572FvLhP6JNABY,372
 osbot_utils/helpers/flows/models/__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=eQzyZVxZjglzPmoxLJ7ib1pD8187YcKBIr7mljpSUF4,11731
+osbot_utils/helpers/generators/Generator_Manager.py,sha256=XxE7ZZvziorolEM5FoMq-5yOFUi3yVaWcPB_XWHtm30,11728
 osbot_utils/helpers/generators/Model__Generator_State.py,sha256=cS9tigdBIAvexip2VC8B0meegslzlu-cOosTDiEpe54,903
-osbot_utils/helpers/generators/Model__Generator_Target.py,sha256=JKa_PEQeVNZDSMBAobADaor4zXAhM_XWPHrQ2NMApZs,819
+osbot_utils/helpers/generators/Model__Generator_Target.py,sha256=Sh_1J0_RYOBYKqg19DP4_e2MPx6CHCzydkA56F8SjRs,816
 osbot_utils/helpers/generators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/html/Dict_To_Css.py,sha256=u6B4Mx7PXr-gDrTrs1hgknnvsZVK4Fic5LqedKjo-lk,1097
 osbot_utils/helpers/html/Dict_To_Html.py,sha256=OlRSaDGOeseBNTxRB2ho5whqEacMXeAXWOfeVSEYqC4,3355
@@ -173,7 +168,7 @@ osbot_utils/helpers/html/Tag__Html.py,sha256=W_QFUF27vpR109g9rpca0zoQis1wkMjGuAt
 osbot_utils/helpers/html/Tag__Link.py,sha256=rQ-gZN8EkSv5x1S-smdjvFflwMQHACHQXiOdx0MFke8,437
 osbot_utils/helpers/html/Tag__Style.py,sha256=LPPlIN7GyMvfCUlbs2eXVMUr9jS0PX5M94A5Ig_jXIs,846
 osbot_utils/helpers/html/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/pubsub/Event__Queue.py,sha256=H4Hhmj_G3GjTcPFj6y1nVFt64vCwGRVdgta0T0b_a4E,5041
+osbot_utils/helpers/pubsub/Event__Queue.py,sha256=bCtIdVlAuG-jvFEnz14oNhgRScEUrd8v9BqLcZleGks,5038
 osbot_utils/helpers/pubsub/PubSub__Client.py,sha256=6K3l4H-Tc0DhktrxpYzLVur1uZ532pQsHWprLNRXFJE,2316
 osbot_utils/helpers/pubsub/PubSub__Room.py,sha256=3drJIAVSAzXB_0Q9dXxwhYWxNaEUaMiWiXLY9Mh02DM,481
 osbot_utils/helpers/pubsub/PubSub__Server.py,sha256=DjQ6PsNGmULdFodspdNktADcoIN3FbdvAitE52m89-w,3548
@@ -192,7 +187,7 @@ osbot_utils/helpers/python_compatibility/__init__.py,sha256=47DEQpj8HBSa-_TImW-5
 osbot_utils/helpers/python_compatibility/python_3_8.py,sha256=kh846vs3ir8xD0RSARJBOL0xufnt3L_Td3K45lDfqng,161
 osbot_utils/helpers/sqlite/Capture_Sqlite_Error.py,sha256=GSuRYgs1yKQjxMszPoaI7fsfMfuUqhb64AaIysRE6Cs,1747
 osbot_utils/helpers/sqlite/Sqlite__Cursor.py,sha256=k5G9Tkk3nx6nHoSanLmpuJG_TceAmN7uRBCt0bo6sIc,3364
-osbot_utils/helpers/sqlite/Sqlite__Database.py,sha256=YSuppFFiR-RcGiAXxhS-Oygw5PvdbV94wm4ybQ7cOF8,5616
+osbot_utils/helpers/sqlite/Sqlite__Database.py,sha256=Ts0qM3Nakot5o9wbFaaW3iq2pDl9USfXGS8GFUBD2wY,5613
 osbot_utils/helpers/sqlite/Sqlite__Field.py,sha256=oBWglAOKN0EWVtaRwiQFxmR1FQ61lQ35yKkWXjSiihs,2911
 osbot_utils/helpers/sqlite/Sqlite__Globals.py,sha256=aP6uIy_y4xzl2soTUCFIJRjsb8JyfxfL6qIEZKIWy_4,230
 osbot_utils/helpers/sqlite/Sqlite__Table.py,sha256=FsFSolFN2N5V8DfZPp4gZL9xmCXaOhmG38wQmgRrvp8,15145
@@ -201,9 +196,9 @@ osbot_utils/helpers/sqlite/Temp_Sqlite__Database__Disk.py,sha256=-BhK0_3lSJPWDt-
 osbot_utils/helpers/sqlite/Temp_Sqlite__Table.py,sha256=Na2dOHlYSVUKK7STHwdzBYbQgvW2a6cEhUnlC0-T8wk,729
 osbot_utils/helpers/sqlite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/sqlite/cache/Schema__Table__Requests.py,sha256=fvLyTYYKighMEjZW2gGrKoyKIqDoitrvO0l0nLdDqTs,381
-osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests.py,sha256=v6a1pDzdwIfk-5KQajz1NTNrIozYFxxxIrxDnppsli8,6190
+osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests.py,sha256=SC-NBsj-wsAcv95YqZ9Ry0ClxRoUMPwkGhBTXw2jTRM,6187
 osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests__Patch.py,sha256=HB-LbZQ0VHi9cJm0647WJKUZIjesMppKQ3ZbTOsMgCI,2474
-osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests__Sqlite.py,sha256=HInQAjpmPysVkAcizaZkZe4WD8LENk3zX9h9-3yAJeM,782
+osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests__Sqlite.py,sha256=vaijPsoQU2_2uQEBa_ukeA6o-EhJkn2KmhKJ3_hse3o,779
 osbot_utils/helpers/sqlite/cache/Sqlite__Cache__Requests__Table.py,sha256=77uO-8WLmzBh5A4Y2VVclKlp2kn1aZ6iJVCtOr4zYFo,2830
 osbot_utils/helpers/sqlite/cache/Sqlite__DB__Requests.py,sha256=CWB-hTcgly2T_7HOZM5gUgfdsvgMus5nX2M_wpjVLZs,1643
 osbot_utils/helpers/sqlite/cache/TestCase__Sqlite__Cache__Requests.py,sha256=TLUdQC6vsf5BcDP15CCeoYkipVG30bzqFcqEJpH4dWg,1645
@@ -228,17 +223,17 @@ osbot_utils/helpers/sqlite/tables/Sqlite__Table__Files.py,sha256=4YguiuqzcfTadPW
 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/SSH.py,sha256=jyRZIL8rif1Fn76i0ZJWSkY0VyQuB1J2LAWIvu4jKpU,1545
+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=YSZEsS_j2PWyfGQNYNv2lvvo2tZlT3pGIwx0YLRqZ4w,6969
+osbot_utils/helpers/ssh/SSH__Execute.py,sha256=xmJe7JySTX2TG9TuL_fGFDkz91Yz1TL6ntubE1Myh5Q,6966
 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
-osbot_utils/helpers/ssh/SSH__Python.py,sha256=O2DAwkbXzwkis8lffoqIL2NPSfYcN44Mr8i9Ey2iMKk,2066
+osbot_utils/helpers/ssh/SSH__Python.py,sha256=MoihfGU1qhl4tdM4s0AifjRVQP75gEuJk-OYSC3F_XI,2063
 osbot_utils/helpers/ssh/TestCase__SSH.py,sha256=MD8sq0_kI4f6pEmEO0cLq2mQOhIqbP45ZxFJNG44Jg4,1773
 osbot_utils/helpers/ssh/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/trace/Trace_Call.py,sha256=O_y6cncgneYrj3ARDMz-o9Yi1LjsESibUqkGFAg0Jk0,8886
-osbot_utils/helpers/trace/Trace_Call__Config.py,sha256=UAjdsDEqsPBBsu-h4_QKYL4UMukJmQYBBWGYTmSKS40,3361
+osbot_utils/helpers/trace/Trace_Call__Config.py,sha256=jppE8zenVvyEOOTP218eDL9wciZztxA100VZTUWmhs8,3358
 osbot_utils/helpers/trace/Trace_Call__Handler.py,sha256=lXMk_7M9SK7s13qNpLuk5qx9CJJ3lzMJGdI8tB-nO-c,12744
 osbot_utils/helpers/trace/Trace_Call__Print_Lines.py,sha256=cy7zLv0_JNxdOIQPfZk6J9bv6AkIW6O643w0ykClXbw,4820
 osbot_utils/helpers/trace/Trace_Call__Print_Traces.py,sha256=2LGeWMGP1uhSojGMmJmL3bH2B5LFIlfYEqEPNqoyKJw,8628
@@ -248,26 +243,19 @@ osbot_utils/helpers/trace/Trace_Call__Stats.py,sha256=gmiotIrOXe2ssxodzQQ56t8eGT
 osbot_utils/helpers/trace/Trace_Call__View_Model.py,sha256=a40nn6agCEMd2ecsJ93n8vXij0omh0D69QilqwmN_ao,4545
 osbot_utils/helpers/trace/Trace_Files.py,sha256=SNpAmuBlSUS9NyVocgZ5vevzqVaIqoh622yZge3a53A,978
 osbot_utils/helpers/trace/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/type_safe/Type_Safe__Validator.py,sha256=cJIPSBarjV716SZUOLvz7Mthjk-aUYKUQtRDtKUBmN4,779
-osbot_utils/helpers/type_safe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/type_safe/validators/Validator__Max.py,sha256=UxrS-tDS5RqfV5aCSbgoGcKHC9VPGqeS_ACB1dqNpQw,1272
-osbot_utils/helpers/type_safe/validators/Validator__Min.py,sha256=krNnQjt8XCS5smESvGsFHw2dJWmS9VKn6WXcY1xatkY,1978
-osbot_utils/helpers/type_safe/validators/Validator__One_Of.py,sha256=AEknqmurAilHMOvbL6EBxAho2pz4llKPNeX0FHBPru8,678
-osbot_utils/helpers/type_safe/validators/Validator__Regex.py,sha256=k6mZSDM1lISwCK-Atnuw5TTe1qx6DIf-DbzT4hL1Pu8,1005
-osbot_utils/helpers/type_safe/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/xml/Xml__Attribute.py,sha256=r29x8ehRug27KuHQKQEGl6Thz_MNaNHy6X3cPRgH4ho,148
-osbot_utils/helpers/xml/Xml__Element.py,sha256=J0hMaJPIBNmZf4wo0xrtZBZd5vWie5FoX9XqtAXQToM,871
-osbot_utils/helpers/xml/Xml__File.py,sha256=c3axXx07rIoK5tGzpLwH-X1B7nusSe1-SZAxJNZJ0KI,420
-osbot_utils/helpers/xml/Xml__File__Load.py,sha256=iAH21HjrqFoZlU5-Kg2RE53RBdNs0mDaASETUTnbhRo,3625
-osbot_utils/helpers/xml/Xml__File__To_Dict.py,sha256=1KGswrpMpUPu4JDYUbkP8GTOQfHGcGONnDYsi-_aqv0,2061
-osbot_utils/helpers/xml/Xml__File__To_Xml.py,sha256=HvUbYOfLz6i160_to90dP3b1uy3Z85nnj7qaGN8LEBI,2884
+osbot_utils/helpers/xml/Xml__Attribute.py,sha256=_dIVyp0WHfdv306vAj5bpEtiqKa83MLKRH925rjKa94,145
+osbot_utils/helpers/xml/Xml__Element.py,sha256=NLRdiTsRhqRf0I0ScAdN-tHuSh2qNuKP_tldx7iiSv4,868
+osbot_utils/helpers/xml/Xml__File.py,sha256=JbD6bDvqpN458mO5_p9ZK8QfuUJAIge9iVI4woNqO2o,417
+osbot_utils/helpers/xml/Xml__File__Load.py,sha256=zvs5yGLk5wf16zadWcTD97R4ltn_Hlap39KkkmrtOx0,3622
+osbot_utils/helpers/xml/Xml__File__To_Dict.py,sha256=YqOOZ_YYSFteCG-oJu3V2Sg9Rr4w2cARv52G3BnfbIY,2058
+osbot_utils/helpers/xml/Xml__File__To_Xml.py,sha256=j_JyEsjKGp1TUxAKECHKRo_mlyO0wjR3x_rGb_dn52M,2881
 osbot_utils/helpers/xml/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/xml/rss/RSS__Channel.py,sha256=HPLsGRNIaPh0_8GYE2a53bSV5Bb4E6j6tKGuy4bxg4Y,605
-osbot_utils/helpers/xml/rss/RSS__Enclosure.py,sha256=f75U7nXXJ7hLs2zPDui0WsFAmMJaeaverjlxD4M-Otg,142
-osbot_utils/helpers/xml/rss/RSS__Feed.py,sha256=lhFoeBMWdH1Dp8QnagCGj9bfZHKmB_HkE56hPVZNaM0,425
+osbot_utils/helpers/xml/rss/RSS__Channel.py,sha256=iAlAqeoHVEhaHqUgQ9DK7xPZwikQS34z0pgXfE7qQeM,602
+osbot_utils/helpers/xml/rss/RSS__Enclosure.py,sha256=9lUsIVJ4TkR_mBFDc6-ISMg7fPXe8FiKFSWjpnlWIMY,139
+osbot_utils/helpers/xml/rss/RSS__Feed.py,sha256=W4T2rmJoZr4kfOPSkZXkkKPnOk5bPlZfLzOf7pah9LQ,422
 osbot_utils/helpers/xml/rss/RSS__Feed__Parser.py,sha256=7sub6zcWqGz8FORXFYRyopTswboUkCU5uGEXAZ6BZDw,5380
-osbot_utils/helpers/xml/rss/RSS__Image.py,sha256=4uI0jd17pqb8FJ8HQcERXvn3WjGbiOVI8u1tv-IN59U,171
-osbot_utils/helpers/xml/rss/RSS__Item.py,sha256=y-QI2WBfd9FEsVWc_eNirvZUUslpb2z27hxcm-RVHJQ,611
+osbot_utils/helpers/xml/rss/RSS__Image.py,sha256=13k8K03VTZbP0efeDL07oZF7Lg0CQccXBd1Qk965mHY,168
+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
@@ -280,7 +268,7 @@ osbot_utils/testing/Profiler.py,sha256=4em6Lpp0ONRDoDDCZsc_CdAOi_QolKOp4eA7KHN96
 osbot_utils/testing/Pytest.py,sha256=R3qdsIXGcNQcu7iobz0RB8AhbbHhc6t757tZoSZRrxA,730
 osbot_utils/testing/Stderr.py,sha256=ynf0Wle9NvgneLChzAxFBQ0QlE5sbri_fzJ8bEJMNkc,718
 osbot_utils/testing/Stdout.py,sha256=Gmxd_dOplXlucdSbOhYhka9sWP-Hmqb7ZuLs_JjtW7Y,592
-osbot_utils/testing/Temp_Env_Vars.py,sha256=mQsc_ogtx2TA_20Y5zPusUZGvk_EZv4PMZjAXElbtFw,933
+osbot_utils/testing/Temp_Env_Vars.py,sha256=3HK_miVX8fya7y9kYgkVwWmoF-PfJpUUOkwatFkK3QI,930
 osbot_utils/testing/Temp_File.py,sha256=yZBL9MmcNU4PCQ4xlF4rSss4GylKoX3T_AJF-BlQhdI,1693
 osbot_utils/testing/Temp_Folder.py,sha256=Dbcohr2ciex6w-kB79R41Nuoa0pgpDbKtPGnlMmJ73k,5194
 osbot_utils/testing/Temp_Sys_Path.py,sha256=gOMD-7dQYQlejoDYUqsrmuZQ9DLC07ymPZB3zYuNmG4,256
@@ -290,6 +278,18 @@ osbot_utils/testing/Temp_Zip_In_Memory.py,sha256=ibDIWt3K4CX558PbkLbX3InHyWYZcwQ
 osbot_utils/testing/Unit_Test.py,sha256=MReR_wDGbbXFDPz7cmuGflcTxRB6TBnO9mYqRpSq8Pk,1304
 osbot_utils/testing/Unzip_File.py,sha256=V5H97XO9rlvG5EYOSzAH4kTtAH1ohZ8R8ImvJh46ZNg,1177
 osbot_utils/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/type_safe/Type_Safe.py,sha256=8FsDdYsfoCgnev5GZdzuuZxxTYDY4RvkyNrp_kZ6QZY,29024
+osbot_utils/type_safe/Type_Safe_Method.py,sha256=8E88of__An9_ZhJKz6Kp22C1mb9WLED0jWNLOII3fJs,10489
+osbot_utils/type_safe/Type_Safe__Base.py,sha256=mL8GMaR9tsaUfwk8d-8zp2g-A8kNKiN6kroEFaNvMOk,5518
+osbot_utils/type_safe/Type_Safe__Dict.py,sha256=I_Ac0JH-ahmQrkADFVyiobTlH1JI31MKHaNszQW4PBo,2396
+osbot_utils/type_safe/Type_Safe__List.py,sha256=SzSIBkwSOAEpW_V2qh4-f0YHzmgB0T8PczBLbDgZGvg,1340
+osbot_utils/type_safe/Type_Safe__Validator.py,sha256=cJIPSBarjV716SZUOLvz7Mthjk-aUYKUQtRDtKUBmN4,779
+osbot_utils/type_safe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/type_safe/validators/Validator__Max.py,sha256=ctsMADDqq9l9mxwedrOfI9Dg53nPxCsluB0cO8C6bT4,1264
+osbot_utils/type_safe/validators/Validator__Min.py,sha256=FfVoErZcibqYXvnH-Nl9c2pfPSKFH-CgAhUVBYsxVrc,1970
+osbot_utils/type_safe/validators/Validator__One_Of.py,sha256=RvEYjf2zT06LVucZeNhzFqTZOh-Bs-C9UNjXd_YLWa8,670
+osbot_utils/type_safe/validators/Validator__Regex.py,sha256=BZemPOU8XWc9bxk4jqPm_adnfhbOf6GD4-gatr_L0wo,997
+osbot_utils/type_safe/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/utils/Assert.py,sha256=u9XLgYn91QvNWZGyPi29SjPJSXRHlm9andIn3NJEVog,1745
 osbot_utils/utils/Call_Stack.py,sha256=awhWstC2mJCrOjNqNheTe2B7at-JFP6XG7VkMPpPNOE,6647
 osbot_utils/utils/Csv.py,sha256=oHLVpjRJqrLMz9lubMCNEoThXWju5rNTprcwHc1zq2c,1012
@@ -307,7 +307,7 @@ osbot_utils/utils/Misc.py,sha256=H_xexJgiTxB3jDeDiW8efGQbO0Zuy8MM0iQ7qXC92JI,173
 osbot_utils/utils/Objects.py,sha256=7QS_rBiLMLiD28be_br-7NrLfR7LtxFImjUGko8MqXM,21933
 osbot_utils/utils/Png.py,sha256=V1juGp6wkpPigMJ8HcxrPDIP4bSwu51oNkLI8YqP76Y,1172
 osbot_utils/utils/Process.py,sha256=lr3CTiEkN3EiBx3ZmzYmTKlQoPdkgZBRjPulMxG-zdo,2357
-osbot_utils/utils/Python_Logger.py,sha256=tx8N6wRKL3RDHboDRKZn8SirSJdSAE9cACyJkxrThZ8,12792
+osbot_utils/utils/Python_Logger.py,sha256=M9Oi62LxfnRSlCN8GhaiwiBINvcSdGy39FCWjyDD-Xg,12792
 osbot_utils/utils/Regex.py,sha256=MtHhk69ax7Nwu4CQZK7y4KXHZ6VREwEpIchuioB168c,960
 osbot_utils/utils/Status.py,sha256=Yq4s0TelXgn0i2QjCP9V8mP30GabXp_UL-jjM6Iwiw4,4305
 osbot_utils/utils/Str.py,sha256=KQVfh0o3BxJKVm24yhAhgIGH5QYfzpP1G-siVv2zQws,3301
@@ -316,8 +316,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=hj792tBZ6NCLSnkj5lttcLXORlnd4_1CyyedSRJmqaU,8
-osbot_utils-1.95.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-osbot_utils-1.95.0.dist-info/METADATA,sha256=erJLyJM0vNgo9YzaCaN6X99UyNcYPlgv1mh9enE0HyE,1317
-osbot_utils-1.95.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-osbot_utils-1.95.0.dist-info/RECORD,,
+osbot_utils/version,sha256=-3MMyLuBjmK9ygVGlyvQ_Mc51URgnLeD4U4j_MbsNV8,7
+osbot_utils-2.1.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+osbot_utils-2.1.0.dist-info/METADATA,sha256=0z546iiaOhdptx11H5Rkku5U7OqeThn6I_J6Fa4dGiY,1315
+osbot_utils-2.1.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+osbot_utils-2.1.0.dist-info/RECORD,,

osbot_utils/base_classes/Type_Safe__Dict.py

@@ -1,22 +0,0 @@
-from osbot_utils.base_classes.Type_Safe__Base import type_str, Type_Safe__Base
-
-class Type_Safe__Dict(Type_Safe__Base, dict):
-    def __init__(self, expected_key_type, expected_value_type, *args, **kwargs):
-        super().__init__(*args, **kwargs)
-
-        self.expected_key_type   = expected_key_type
-        self.expected_value_type = expected_value_type
-
-        for k, v in self.items():                           # check type-safety of ctor arguments
-            self.is_instance_of_type(k, self.expected_key_type  )
-            self.is_instance_of_type(v, self.expected_value_type)
-
-    def __setitem__(self, key, value):                                  # Check type-safety before allowing assignment.
-        self.is_instance_of_type(key, self.expected_key_type)
-        self.is_instance_of_type(value, self.expected_value_type)
-        super().__setitem__(key, value)
-
-    def __repr__(self):
-        key_type_name   = type_str(self.expected_key_type)
-        value_type_name = type_str(self.expected_value_type)
-        return f"dict[{key_type_name}, {value_type_name}] with {len(self)} entries"

osbot_utils/base_classes/Type_Safe__List.py

@@ -1,22 +0,0 @@
-from osbot_utils.base_classes.Type_Safe__Base import Type_Safe__Base, type_str
-
-
-class Type_Safe__List(Type_Safe__Base, list):
-
-    def __init__(self, expected_type, *args):
-        super().__init__(*args)
-        self.expected_type = expected_type
-
-    def __repr__(self):
-        expected_type_name = type_str(self.expected_type)
-        return f"list[{expected_type_name}] with {len(self)} elements"
-
-    def append(self, item):
-        try:
-            self.is_instance_of_type(item, self.expected_type)
-        except TypeError as e:
-            raise TypeError(f"In Type_Safe__List: Invalid type for item: {e}")
-        super().append(item)
-
-
-