Merge dev into main

Author: DinisCruz

README.md

@@ -1,6 +1,6 @@
 # OSBot-Utils
 
-![Current Release](https://img.shields.io/badge/release-v3.54.0-blue)
+![Current Release](https://img.shields.io/badge/release-v3.54.1-blue)
 ![Python](https://img.shields.io/badge/python-3.8+-green)
 ![Type-Safe](https://img.shields.io/badge/Type--Safe-✓-brightgreen)
 ![Caching](https://img.shields.io/badge/Caching-Built--In-orange)

osbot_utils/type_safe/type_safe_core/shared/Type_Safe__Validation.py

@@ -22,6 +22,10 @@ def are_types_compatible_for_assigment(self, source_type, target_type):
         import types
         import typing
 
+        if source_type is None:
+            return target_type is type(None) or target_type is None or target_type is typing.Any
+
+
         if isinstance(target_type, str):                                    # If the "target_type" is a forward reference (string), handle it here.
             if target_type == source_type.__name__:                         # Simple check: does the string match the actual class name
                 return True
@@ -119,6 +123,13 @@ def check_if__type_matches__union_type(self, annotation : Any,
         if value_type in args:                                              # Direct match
             return True
 
+        if value_type is types.FunctionType: # Handle Callable types within Union (e.g., Optional[Callable[[str], None]]), hen value_type is a function, check if any union arg is a compatible Callable
+            for arg in args:
+                arg_origin = type_safe_cache.get_origin(arg)
+                if arg_origin is collections.abc.Callable:
+                    return True  # Accept functions for Callable annotations in unions  , Full signature validation happens elsewhere
+
+
         if value_type in TYPE_MAPPINGS:                                     # Check for typing generics equivalence
             if TYPE_MAPPINGS[value_type] in args:                           # If value_type is a built-in, check if its typing equivalent is in args
                 return True

osbot_utils/version

@@ -1 +1 @@
-v3.54.0
+v3.54.1

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name        = "osbot_utils"
-version     = "v3.54.0"
+version     = "v3.54.1"
 description = "OWASP Security Bot - Utils"
 authors     = ["Dinis Cruz <[email protected]>"]
 license     = "MIT"

tests/unit/helpers/html/transformers/test_Html__To__Html_Dict.py

@@ -1,7 +1,7 @@
-from unittest                                       import TestCase
+from unittest                                                    import TestCase
 from osbot_utils.helpers.html.transformers.Html_Dict__To__Html   import Html_Dict__To__Html
 from osbot_utils.helpers.html.transformers.Html__To__Html_Dict   import Html__To__Html_Dict, STRING__SCHEMA_TEXT
-from tests._test_data.Sample_Test_Files             import Sample_Test_Files
+from tests._test_data.Sample_Test_Files                          import Sample_Test_Files
 
 
 class test_Html__To__Html_Dict(TestCase):

tests/unit/type_safe/type_safe_core/_bugs/test_Type_Safe__bugs.py

@@ -97,6 +97,4 @@ class Extended_Config(Base_Config):
         #      because Base_Handler is not a subclass of Extended_Handler
         error_message = "On Extended_Config, invalid type for attribute 'handler_type'. Expected 'typing.Type["
         with pytest.raises(ValueError, match=re.escape(error_message)):
-            Extended_Config()                                           # BUG: should auto-assign Extended_Handler
-
-
+            Extended_Config()                                           # BUG: should auto-assign Extended_Handler