orionis 0.294.0__py3-none-any.whl → 0.296.0__py3-none-any.whl

orionis/metadata/framework.py

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

orionis/services/introspection/dependencies/contracts/reflect_dependencies.py

@@ -4,40 +4,46 @@ from orionis.services.introspection.dependencies.entities.method_dependencies im
 
 class IReflectDependencies(ABC):
     """
-    This class is used to reflect dependencies of a given object.
-    """
+    Interface for reflecting dependencies of a given object.
 
-    def __init__(self, obj):
-        self.__obj = obj
+    This interface provides methods to retrieve both resolved and unresolved
+    dependencies from the constructor and methods of a class.
+    """
 
     @abstractmethod
     def getConstructorDependencies(self) -> ClassDependency:
         """
-        Get the resolved and unresolved dependencies from the constructor of the instance's class.
+        Retrieve dependencies from the constructor of the instance's class.
 
         Returns
         -------
         ClassDependency
-            A structured representation of the constructor dependencies, containing:
-            - resolved: Dictionary of resolved dependencies with their names and values.
-            - unresolved: List of unresolved dependencies (parameter names without default values or annotations).
+            Structured representation of the constructor dependencies.
+
+            - resolved : dict
+                Dictionary of resolved dependencies with their names and values.
+            - unresolved : list
+                List of unresolved dependencies (parameter names without default values or annotations).
         """
         pass
 
     def getMethodDependencies(self, method_name: str) -> MethodDependency:
         """
-        Get the resolved and unresolved dependencies from a method of the instance's class.
+        Retrieve dependencies from a method of the instance's class.
 
         Parameters
         ----------
         method_name : str
-            The name of the method to inspect
+            Name of the method to inspect.
 
         Returns
         -------
         MethodDependency
-            A structured representation of the method dependencies, containing:
-            - resolved: Dictionary of resolved dependencies with their names and values.
-            - unresolved: List of unresolved dependencies (parameter names without default values or annotations).
+            Structured representation of the method dependencies.
+
+            - resolved : dict
+                Dictionary of resolved dependencies with their names and values.
+            - unresolved : list
+                List of unresolved dependencies (parameter names without default values or annotations).
         """
         pass

orionis/services/introspection/dependencies/entities/class_dependencies.py

@@ -1,19 +1,28 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
 class ClassDependency:
     """
     Represents the dependencies of a class, separating resolved and unresolved dependencies.
 
-    Attributes:
-        resolved (Dict[ResolvedDependency, Any]):
-            A dictionary mapping resolved dependency descriptors to their corresponding resolved instances or values.
-            All keys must be ResolvedDependency instances.
-        unresolved (List[str]):
-            A list of dependency names or identifiers that could not be resolved.
-            Must contain only strings.
+    Parameters
+    ----------
+    resolved : Dict[ResolvedDependency, Any]
+        A dictionary mapping resolved dependency descriptors to their corresponding resolved instances or values.
+        All keys must be ResolvedDependency instances.
+    unresolved : List[str]
+        A list of dependency names or identifiers that could not be resolved.
+        Must contain only strings.
+
+    Attributes
+    ----------
+    resolved : Dict[ResolvedDependency, Any]
+        Dictionary of resolved dependencies.
+    unresolved : List[str]
+        List of unresolved dependency names.
     """
     resolved: Dict[ResolvedDependency, Any]
     unresolved: List[str]
@@ -22,20 +31,23 @@ class ClassDependency:
         """
         Validates types of attributes during initialization.
 
-        Raises:
-            TypeError: If types don't match the expected:
+        Raises
+        ------
+        ReflectionTypeError
+            If types don't match the expected:
                 - resolved: Dict[ResolvedDependency, Any]
                 - unresolved: List[str]
-            ValueError: If resolved contains None keys or unresolved contains empty strings
+        ValueError
+            If resolved contains None keys or unresolved contains empty strings.
         """
         # Validate 'resolved' is a dict with ResolvedDependency keys
         if not isinstance(self.resolved, dict):
-            raise TypeError(
+            raise ReflectionTypeError(
                 f"'resolved' must be a dict, got {type(self.resolved).__name__}"
             )
 
         # Validate 'unresolved' is a list of non-empty strings
         if not isinstance(self.unresolved, list):
-            raise TypeError(
+            raise ReflectionTypeError(
                 f"'unresolved' must be a list, got {type(self.unresolved).__name__}"
             )

orionis/services/introspection/dependencies/entities/method_dependencies.py

@@ -1,20 +1,30 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
 class MethodDependency:
     """
     Represents the dependencies of a method, separating resolved and unresolved dependencies.
 
-    Attributes:
-        resolved (Dict[ResolvedDependency, Any]):
-            A dictionary mapping resolved dependency descriptors to their corresponding
-            resolved instances or values for the method.
-            All keys must be ResolvedDependency instances.
-        unresolved (List[str]):
-            A list of method parameter names or dependency identifiers that could not be resolved.
-            Must contain only non-empty strings.
+    Parameters
+    ----------
+    resolved : Dict[ResolvedDependency, Any]
+        A dictionary mapping resolved dependency descriptors to their corresponding
+        resolved instances or values for the method. All keys must be ResolvedDependency instances.
+    unresolved : List[str]
+        A list of method parameter names or dependency identifiers that could not be resolved.
+        Must contain only non-empty strings.
+
+    Raises
+    ------
+    ReflectionTypeError
+        If types don't match the expected:
+            - resolved: Dict[ResolvedDependency, Any]
+            - unresolved: List[str]
+    ValueError
+        If resolved contains None keys or unresolved contains empty strings
     """
     resolved: Dict[ResolvedDependency, Any]
     unresolved: List[str]
@@ -23,20 +33,23 @@ class MethodDependency:
         """
         Validates types and values of attributes during initialization.
 
-        Raises:
-            TypeError: If types don't match the expected:
+        Raises
+        ------
+        ReflectionTypeError
+            If types don't match the expected:
                 - resolved: Dict[ResolvedDependency, Any]
                 - unresolved: List[str]
-            ValueError: If resolved contains None keys or unresolved contains empty strings
+        ValueError
+            If resolved contains None keys or unresolved contains empty strings
         """
         # Validate 'resolved' is a dict with proper key types
         if not isinstance(self.resolved, dict):
-            raise TypeError(
+            raise ReflectionTypeError(
                 f"'resolved' must be a dict, got {type(self.resolved).__name__}"
             )
 
         # Validate 'unresolved' is a list of valid parameter names
         if not isinstance(self.unresolved, list):
-            raise TypeError(
+            raise ReflectionTypeError(
                 f"'unresolved' must be a list, got {type(self.unresolved).__name__}"
             )

orionis/services/introspection/dependencies/entities/resolved_dependencies.py

@@ -1,23 +1,33 @@
 from dataclasses import dataclass
 from typing import Type, Any
 
+from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
+
 @dataclass(frozen=True, kw_only=True)
 class ResolvedDependency:
     """
     Represents a fully resolved dependency with complete type information.
 
-    Attributes:
-        module_name (str):
-            The name of the module where the dependency is defined.
-            Must be a non-empty string without spaces.
-        class_name (str):
-            The name of the class/type being resolved.
-            Must be a valid Python identifier.
-        type (Type):
-            The actual Python type object of the resolved dependency.
-        full_class_path (str):
-            The full import path to the class (e.g., 'package.module.ClassName').
-            Must match 'module_name.class_name' pattern.
+    Parameters
+    ----------
+    module_name : str
+        The name of the module where the dependency is defined.
+        Must be a non-empty string without spaces.
+    class_name : str
+        The name of the class/type being resolved.
+        Must be a valid Python identifier.
+    type : Type
+        The actual Python type object of the resolved dependency.
+    full_class_path : str
+        The full import path to the class (e.g., 'package.module.ClassName').
+        Must match 'module_name.class_name' pattern.
+
+    Raises
+    ------
+    ReflectionTypeError
+        If any field has incorrect type.
+    ValueError
+        If string fields are empty or don't meet format requirements.
     """
     module_name: str
     class_name: str
@@ -28,17 +38,20 @@ class ResolvedDependency:
         """
         Validates all fields during initialization.
 
-        Raises:
-            TypeError: If any field has incorrect type.
-            ValueError: If string fields are empty or don't meet format requirements.
+        Raises
+        ------
+        ReflectionTypeError
+            If any field has incorrect type.
+        ValueError
+            If string fields are empty or don't meet format requirements.
         """
         # Validate module_name
         if not isinstance(self.module_name, str):
-            raise TypeError(f"module_name must be str, got {type(self.module_name).__name__}")
+            raise ReflectionTypeError(f"module_name must be str, got {type(self.module_name).__name__}")
 
         # Validate class_name
         if not isinstance(self.class_name, str):
-            raise TypeError(f"class_name must be str, got {type(self.class_name).__name__}")
+            raise ReflectionTypeError(f"class_name must be str, got {type(self.class_name).__name__}")
 
         # Validate type
         if self.type is None:
@@ -46,4 +59,4 @@ class ResolvedDependency:
 
         # Validate full_class_path
         if not isinstance(self.full_class_path, str):
-            raise TypeError(f"full_class_path must be str, got {type(self.full_class_path).__name__}")
+            raise ReflectionTypeError(f"full_class_path must be str, got {type(self.full_class_path).__name__}")

orionis/services/introspection/dependencies/reflect_dependencies.py

@@ -4,6 +4,7 @@ from orionis.services.introspection.dependencies.contracts.reflect_dependencies
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.exceptions.reflection_value_error import ReflectionValueError
 
 class ReflectDependencies(IReflectDependencies):
     """
@@ -67,16 +68,16 @@ class ReflectDependencies(IReflectDependencies):
 
         Raises
         ------
-        ValueError
+        ReflectionValueError
             If the signature cannot be inspected.
         """
         if not callable(target):
-            raise ValueError(f"Target {target} is not callable and cannot have a signature.")
+            raise ReflectionValueError(f"Target {target} is not callable and cannot have a signature.")
 
         try:
             return inspect.signature(target)
-        except (ValueError, TypeError) as e:
-            raise ValueError(f"Unable to inspect signature of {target}: {str(e)}")
+        except (ReflectionValueError, TypeError, Exception) as e:
+            raise ReflectionValueError(f"Unable to inspect signature of {target}: {str(e)}")
 
     def getConstructorDependencies(self) -> ClassDependency:
         """

orionis/services/introspection/exceptions/reflection_type_error.py

@@ -0,0 +1,26 @@
+class ReflectionTypeError(Exception):
+    """
+    Base class for all reflection-related exceptions.
+    """
+
+    def __init__(self, msg: str):
+        """
+        Initialize the exception with a custom error message.
+
+        Parameters
+        ----------
+        msg : str
+            The error message describing the exception.
+        """
+        super().__init__(msg)
+
+    def __str__(self) -> str:
+        """
+        Return a string representation of the exception, including the class name and the first argument.
+
+        Returns
+        -------
+        str
+            A formatted string with the exception class name and the first argument.
+        """
+        return f"{self.__class__.__name__}: {self.args[0]}"

orionis/services/introspection/exceptions/reflection_value_error.py

@@ -0,0 +1,26 @@
+class ReflectionValueError(Exception):
+    """
+    Base class for all reflection-related exceptions.
+    """
+
+    def __init__(self, msg: str):
+        """
+        Initialize the exception with a custom error message.
+
+        Parameters
+        ----------
+        msg : str
+            The error message describing the exception.
+        """
+        super().__init__(msg)
+
+    def __str__(self) -> str:
+        """
+        Return a string representation of the exception, including the class name and the first argument.
+
+        Returns
+        -------
+        str
+            A formatted string with the exception class name and the first argument.
+        """
+        return f"{self.__class__.__name__}: {self.args[0]}"

orionis/test/suites/test_suite.py

@@ -80,6 +80,7 @@ class TestSuite(ITestSuite):
             throw_exception=config.throw_exception,
             persistent=config.persistent,
             persistent_driver=config.persistent_driver,
+            web_report=config.web_report
         )
 
         # Extract configuration values

{orionis-0.294.0.dist-info → orionis-0.296.0.dist-info}/METADATA

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

{orionis-0.294.0.dist-info → orionis-0.296.0.dist-info}/RECORD

@@ -226,7 +226,7 @@ orionis/foundation/config/testing/entities/testing.py,sha256=AuhPU9O15Aeqs8jQVHW
 orionis/foundation/config/testing/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/testing/enums/test_mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=aV2GKSisyRjv08CYG9hLpyxUodGeHnrEUyzvebA8xGw,4960
+orionis/metadata/framework.py,sha256=IpTPvA6WGEXwbMnUNpTK4MwqgsElkdxs5NmSV8vn13M,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/patterns/singleton/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -255,15 +255,16 @@ orionis/services/introspection/abstracts/reflect_abstract.py,sha256=JM0jqNIxXAn0
 orionis/services/introspection/abstracts/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/abstracts/entities/abstract_class_attributes.py,sha256=J6zL1REbfnynnCfgjJIzB-D8o3TeT-Yp_QcjdDI8wnU,1513
 orionis/services/introspection/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/dependencies/reflect_dependencies.py,sha256=rPAH0CWmuKkOrnbSoD1M0OzrADfZSVU4C-yCorTfmZ8,6995
+orionis/services/introspection/dependencies/reflect_dependencies.py,sha256=HL2cX7_SSIWeKxzBDUMEdmfjetrZmMfPZvqM34DvJMg,7145
 orionis/services/introspection/dependencies/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/dependencies/contracts/reflect_dependencies.py,sha256=ZJeuTxGGAOY0k9wu4A4IiTmSqfOXGJg1G3UpJfXVRG8,1672
+orionis/services/introspection/dependencies/contracts/reflect_dependencies.py,sha256=5fdImZarC1ixoFM-1JSBx28RvYbY3GGZhDGjar7cvHc,1771
 orionis/services/introspection/dependencies/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/dependencies/entities/class_dependencies.py,sha256=tLskzBMhrAx4OmZUJXXB_5Z41nhdhtqD4y4m5RfWdJQ,1715
-orionis/services/introspection/dependencies/entities/method_dependencies.py,sha256=WHypDCpugtsa5ge1nqVlykHbA0Wo_X7XchDwQpGiM0c,1780
-orionis/services/introspection/dependencies/entities/resolved_dependencies.py,sha256=lrPr-tOx2IPaDlPNyhJ7uXUdnLjKybfntTKTCu7WXJg,1899
+orionis/services/introspection/dependencies/entities/class_dependencies.py,sha256=pALvV_duAvDYmNp7PJYWkpIIQYmqWxuc_RGruEckfPA,2063
+orionis/services/introspection/dependencies/entities/method_dependencies.py,sha256=FDwroILMPhqPxaxisPVEeKeLUg57GNQ4tQfWjGMh40E,2194
+orionis/services/introspection/dependencies/entities/resolved_dependencies.py,sha256=0qnEj-3H8iclCc79AduQrqAAdAihv7k39gipo3RT2zc,2216
 orionis/services/introspection/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/exceptions/types.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/services/introspection/exceptions/reflection_type_error.py,sha256=6BizQOgt50qlLPDBvBJfUWgAwAr_8GAk1FhownPs-8A,747
+orionis/services/introspection/exceptions/reflection_value_error.py,sha256=X38649JMKSPbdpa1lmo69RhhTATH8ykTF-UAqe7IAaU,748
 orionis/services/introspection/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/helpers/functions.py,sha256=-UhQ53o4IU3XwpA2I0e0m8gZaH1DoDKaU_yH2XYqT54,8541
 orionis/services/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -344,14 +345,14 @@ orionis/test/output/dumper.py,sha256=y-6du3n1IU2Cd2MFbMuEiLcpMqEOqENkuAXwMMhcsEI
 orionis/test/output/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/output/contracts/dumper.py,sha256=5OqGc4GEXCXX76sCX185giQMyKwwZvlOv3I7tTwV2fQ,1324
 orionis/test/suites/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/suites/test_suite.py,sha256=fdVmC56PJfWDuYeekY7oN-04AEHMqxwLI5mZNJAuOZI,5261
+orionis/test/suites/test_suite.py,sha256=nJhToYdvHFETSNqunk-_i6Pe716842eaFKDBhChjigA,5303
 orionis/test/suites/test_unit.py,sha256=dnLEEeBnGkE7DRM2XXJPtxHw25JLzP9ZtcGImmBNBM4,54916
 orionis/test/suites/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/suites/contracts/test_suite.py,sha256=eluzYwkNBbKjxYStj_tHN_Fm3YDPpGQdqMu5eiluh-E,1059
 orionis/test/suites/contracts/test_unit.py,sha256=l1LQllODyvcSByXMl1lGrUkoLsXbBHZZLWZI4A-mlQg,5881
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=jXZkbITBknbUwm_mD8bcTiwLDvsFkrO9qrf0ZgPwqxc,4903
-orionis-0.294.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.296.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/test_example.py,sha256=byd_lI6tVDgGPEIrr7PLZbBu0UoZOymmdmyA_4u-QUw,601
@@ -455,8 +456,8 @@ tests/support/inspection/fakes/fake_reflection_instance_with_abstract.py,sha256=
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=MrGK3ZimedL0b5Ydu69Dg8Iul017AzLTm7VPxpXlpfU,4315
 tests/testing/test_testing_unit.py,sha256=A6QkiOkP7GPC1Szh_GqsrV7GxjWjK8cIwFez6YfrzmM,7683
-orionis-0.294.0.dist-info/METADATA,sha256=7lTo0mbUupOIdMFbWCqfYzOOrNiVyGigY9kSGs94hIA,4772
-orionis-0.294.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.294.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.294.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.294.0.dist-info/RECORD,,
+orionis-0.296.0.dist-info/METADATA,sha256=4H2z-lUkh1MAdwf7Ok4wTkIwyVbUvKeaKzTs08KVYzk,4772
+orionis-0.296.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.296.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.296.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.296.0.dist-info/RECORD,,