orionis 0.413.0__py3-none-any.whl → 0.415.0__py3-none-any.whl

orionis/metadata/framework.py

@@ -5,7 +5,7 @@
 NAME = "orionis"
 
 # Current version of the framework
-VERSION = "0.413.0"
+VERSION = "0.415.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

orionis/support/entities/base.py

@@ -5,57 +5,77 @@ class BaseEntity:
 
     def toDict(self) -> dict:
         """
-        Converts the current instance into a dictionary representation.
+        Converts the current dataclass instance into a dictionary.
+
+        Parameters
+        ----------
+        None
 
         Returns
         -------
         dict
-            Dictionary representation of the current instance.
+            A dictionary containing all fields of the instance, with field names as keys and their corresponding values.
+
+        Notes
+        -----
+        This method uses `dataclasses.asdict` to recursively convert the dataclass instance and any nested dataclasses into dictionaries.
+        Enum values are preserved as their actual values.
         """
+
+        # Use asdict to convert the dataclass instance to a dictionary, including nested dataclasses
         return asdict(self)
 
     def getFields(self):
         """
-        Retrieves a list of field information for the current dataclass instance.
+        Retrieves detailed information about each field in the current dataclass instance.
+
+        Parameters
+        ----------
+        None
 
         Returns
         -------
-        list
-            A list of dictionaries, each containing details about a field:
-            - name (str): The name of the field.
-            - type (type): The type of the field.
-            - default: The default value of the field, if specified; otherwise, the value from metadata or None.
-            - metadata (mapping): The metadata associated with the field.
+        list of dict
+            Each dictionary in the returned list contains:
+                - name (str): The name of the field.
+                - types (list of str): The type(s) of the field, represented as a list of type names.
+                - default: The default value of the field, resolved from the field definition, default factory, or metadata.
+                - metadata (dict): The metadata associated with the field.
+
+        Notes
+        -----
+        - Handles complex field types, including unions and generics, by representing them as lists of type names.
+        - Resolves default values from direct assignment, default factories, or metadata, and normalizes dataclass and Enum values.
+        - Metadata defaults are normalized if present and callable or dataclass/Enum types.
         """
-        # Dictionary to hold field information
+
+        # List to hold field information dictionaries
         __fields = []
 
-        # Iterate over the fields of the dataclass and extract relevant information
+        # Iterate over all fields defined in the dataclass
         for field in fields(self):
 
-            # Get the field name
+            # Extract the field name
             __name = field.name
 
-            # Get the field type with better handling for complex types
+            # Attempt to get the type name; handles simple types
             __type = getattr(field.type, '__name__', None)
 
-            # If the type is None, handle it
+            # If type name is not available, handle complex types (e.g., Unions)
             if __type is None:
-
-                # Handle Union types or other complex types
                 type_lst = []
                 type_str = str(field.type).split('|')
                 for itype in type_str:
                     type_lst.append(itype.strip())
                 __type = type_lst
 
-            # Ensure __type is a list for consistency
+            # Ensure __type is always a list for consistency
             __type = type_lst if isinstance(__type, list) else [__type]
 
-            # Extract metadata, default value, and type
+            # Extract metadata as a dictionary
             metadata = dict(field.metadata) if field.metadata else {}
 
-            # If metadata contains a default value, normalize it
+            # Normalize default value in metadata if present
             if 'default' in metadata:
                 metadata_default = metadata['default']
                 if callable(metadata_default):
@@ -66,13 +86,12 @@ class BaseEntity:
                     metadata_default = metadata_default.value
                 metadata['default'] = metadata_default
 
-            # Add the field information to the list
             __metadata = metadata
 
-            # Extract the default value, if specified
+            # Initialize default value
             __default = None
 
-            # Field has a direct default value
+            # Resolve default value from field definition
             if field.default is not MISSING:
                 __default = field.default() if callable(field.default) else field.default
                 if is_dataclass(__default):
@@ -80,7 +99,7 @@ class BaseEntity:
                 elif isinstance(__default, Enum):
                     __default = __default.value
 
-            # Field has a default factory (like list, dict, etc.)
+            # Resolve default value from default factory if present
             elif field.default_factory is not MISSING:
                 __default = field.default_factory() if callable(field.default_factory) else field.default_factory
                 if is_dataclass(__default):
@@ -88,11 +107,11 @@ class BaseEntity:
                 elif isinstance(__default, Enum):
                     __default = __default.value
 
-            # No default found, check metadata for custom default
+            # If no default found, check metadata for custom default
             else:
                 __default = __metadata.get('default', None)
 
-            # Append the field information to the list
+            # Append the field information dictionary to the list
             __fields.append({
                 "name": __name,
                 "types": __type,
@@ -100,5 +119,5 @@ class BaseEntity:
                 "metadata": __metadata
             })
 
-        # Return the list of field information
+        # Return the list of field information dictionaries
         return __fields

orionis/support/facades/console.py

@@ -5,11 +5,17 @@ class Console(Facade):
     @classmethod
     def getFacadeAccessor(cls) -> str:
         """
-        Get the service container binding key for the dumper component.
+        Returns the service container binding key used to resolve the console component.
+
+        This method provides the unique string identifier that the service container uses
+        to locate and instantiate the console service. It is typically used internally
+        by the Facade base class to delegate calls to the underlying implementation.
 
         Returns
         -------
         str
-            The service container binding key.
+            The string key `"core.orionis.console"` that identifies the console service in the container.
         """
+
+        # Return the binding key for the console service in the container
         return "core.orionis.console"

orionis/support/facades/dumper.py

@@ -5,11 +5,17 @@ class Dumper(Facade):
     @classmethod
     def getFacadeAccessor(cls) -> str:
         """
-        Get the service container binding key for the dumper component.
+        Returns the binding key used to retrieve the dumper component from the service container.
+
+        This method provides the unique string identifier that the service container uses to resolve
+        and return the dumper service instance. It is typically used internally by the Facade base class
+        to access the underlying implementation.
 
         Returns
         -------
         str
-            The service container binding key.
+            The string "core.orionis.dumper", which is the service container binding key for the dumper component.
         """
+
+        # Return the service container binding key for the dumper component
         return "core.orionis.dumper"

orionis/support/facades/logger.py

@@ -5,11 +5,18 @@ class Log(Facade):
     @classmethod
     def getFacadeAccessor(cls) -> str:
         """
-        Get the service container binding key for the dumper component.
+        Returns the binding key used to resolve the logger service from the service container.
+
+        This method provides the unique identifier required by the service container to retrieve
+        the logger component. It is used internally by the Facade base class to delegate calls
+        to the appropriate service implementation.
 
         Returns
         -------
         str
-            The service container binding key.
+            The binding key for the logger service in the service container, specifically
+            "core.orionis.logger".
         """
+
+        # Return the service container binding key for the logger component
         return "core.orionis.logger"

orionis/support/facades/path_resolver.py

@@ -5,11 +5,18 @@ class PathResolver(Facade):
     @classmethod
     def getFacadeAccessor(cls):
         """
-        Get the service container binding key for the dumper component.
+        Returns the service container binding key used to resolve the path resolver component.
+
+        This method provides the unique string identifier that the service container uses
+        to locate and retrieve the path resolver service. It is typically used internally
+        by the facade mechanism to delegate calls to the appropriate underlying implementation.
 
         Returns
         -------
         str
-            The service container binding key.
+            The string key "core.orionis.path_resolver" that identifies the path resolver
+            service in the container.
         """
+
+        # Return the binding key for the path resolver service in the container
         return "core.orionis.path_resolver"

orionis/support/facades/progress_bar.py

@@ -5,11 +5,18 @@ class ProgressBar(Facade):
     @classmethod
     def getFacadeAccessor(cls):
         """
-        Get the service container binding key for the dumper component.
+        Returns the binding key used to retrieve the progress bar service from the service container.
+
+        This method provides the unique string identifier that the service container uses to resolve
+        the progress bar component. It is typically used internally by the Facade system to access
+        the underlying implementation.
 
         Returns
         -------
         str
-            The service container binding key.
+            The binding key for the progress bar service in the service container, specifically
+            "core.orionis.progress_bar".
         """
+
+        # Return the service container binding key for the progress bar component
         return "core.orionis.progress_bar"

orionis/support/facades/testing.py

@@ -5,11 +5,18 @@ class Test(Facade):
     @classmethod
     def getFacadeAccessor(cls) -> str:
         """
-        Get the service container binding key for the dumper component.
+        Returns the service container binding key for the testing component.
+
+        This method provides the unique string identifier used by the service container
+        to resolve the testing component. It is typically used internally by the Facade
+        system to retrieve the correct implementation from the container.
 
         Returns
         -------
         str
-            The service container binding key.
+            The string key "core.orionis.testing" that identifies the testing component
+            in the service container.
         """
+
+        # Return the binding key for the testing component in the service container
         return "core.orionis.testing"

orionis/support/facades/workers.py

@@ -5,11 +5,18 @@ class Workers(Facade):
     @classmethod
     def getFacadeAccessor(cls):
         """
-        Get the service container binding key for the dumper component.
+        Returns the service container binding key for the workers component.
+
+        This method provides the unique string identifier used by the service container
+        to resolve the workers service. It is typically used internally by the Facade
+        mechanism to access the underlying implementation.
 
         Returns
         -------
         str
-            The service container binding key.
+            The string key "core.orionis.workers" that identifies the workers service
+            in the service container.
         """
+
+        # Return the binding key for the workers service in the container
         return "core.orionis.workers"

orionis/test/core/unit_test.py

@@ -1,6 +1,5 @@
 import io
 import json
-import os
 import re
 import time
 import traceback
@@ -316,9 +315,27 @@ class UnitTest(IUnitTest):
             tests = self.__loader.discover(
                 start_dir=str(full_path),
                 pattern=self.__pattern,
-                top_level_dir=None
+                top_level_dir="."
             )
 
+            # Check for failed test imports (unittest.loader._FailedTest)
+            for test in self.__flattenTestSuite(tests):
+                if test.__class__.__name__ == "_FailedTest":
+                    # Extract the error message from the test's traceback
+                    error_message = ""
+                    if hasattr(test, "_exception"):
+                        error_message = str(test._exception)
+                    elif hasattr(test, "_outcome") and hasattr(test._outcome, "errors"):
+                        error_message = str(test._outcome.errors)
+                    else:
+                        # Try to get error from test id or str(test)
+                        error_message = str(test)
+                    raise OrionisTestValueError(
+                        f"Failed to import test module: {test.id()}.\n"
+                        f"Error details: {error_message}\n"
+                        "Please check for import errors or missing dependencies."
+                    )
+
             # If name pattern is provided, filter tests by name
             if test_name_pattern:
                 tests = self.__filterTestsByName(
@@ -365,6 +382,7 @@ class UnitTest(IUnitTest):
                 f"Error importing tests from path '{str(full_path)}': {str(e)}.\n"
                 "Please verify that the directory and test modules are accessible and correct."
             )
+
         except Exception as e:
 
             # Raise a general error for unexpected issues
@@ -700,6 +718,11 @@ class UnitTest(IUnitTest):
         # Iterate through all test cases in the original (possibly nested) suite
         for test_case in self.__flattenTestSuite(self.__suite):
 
+            # If it's a failed test, add it as-is to the flattened suite
+            if test_case.__class__.__name__ == "_FailedTest":
+                flattened_suite.addTest(test_case)
+                continue
+
             # Get the test method name using reflection
             rf_instance = ReflectionInstance(test_case)
             method_name = rf_instance.getAttribute("_testMethodName")
@@ -730,14 +753,7 @@ class UnitTest(IUnitTest):
                 continue
 
             # Attempt to extract dependency information from the test method signature
-            try:
-                signature = rf_instance.getMethodDependencies(method_name)
-            except Exception as e:
-                raise OrionisTestValueError(
-                    f"Failed to resolve test dependencies in '../{method_name}.py. "
-                    f"This may be caused by incorrect imports, missing modules, or undefined classes. "
-                    f"Please verify that all test methods and their dependencies are correctly declared and accessible."
-                )
+            signature = rf_instance.getMethodDependencies(method_name)
 
             # If there are no dependencies to resolve, or unresolved dependencies exist, add as-is
             if ((not signature.resolved and not signature.unresolved) or (not signature.resolved and len(signature.unresolved) > 0)):

orionis/test/output/dumper.py

@@ -66,7 +66,7 @@ class TestDumper(ITestDumper):
                     SyncTestCase,
                     unittest.TestCase,
                     unittest.IsolatedAsyncioTestCase
-                ),
+                )
             )
 
         except Exception:

{orionis-0.413.0.dist-info → orionis-0.415.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.413.0
+Version: 0.415.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro