orionis 0.317.0__py3-none-any.whl → 0.319.0__py3-none-any.whl

orionis/container/container.py

@@ -1,4 +1,6 @@
+import threading
 from typing import Any, Callable
+from orionis.container.contracts.container import IContainer
 from orionis.container.entities.binding import Binding
 from orionis.container.enums.lifetimes import Lifetime
 from orionis.container.exceptions.container_exception import OrionisContainerException
@@ -6,12 +8,11 @@ from orionis.container.exceptions.type_error_exception import OrionisContainerTy
 from orionis.services.introspection.abstract.reflection_abstract import ReflectionAbstract
 from orionis.services.introspection.callables.reflection_callable import ReflectionCallable
 from orionis.services.introspection.concretes.reflection_concrete import ReflectionConcrete
+from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
 from orionis.services.introspection.instances.reflection_instance import ReflectionInstance
 from orionis.services.introspection.reflection import Reflection
-import inspect
-import threading
 
-class Container:
+class Container(IContainer):
 
     # Singleton instance of the container.
     # This is a class variable that holds the single instance of the Container class.
@@ -27,7 +28,11 @@ class Container:
     # regardless of how many times the class is instantiated.
     _initialized = False
 
-    def __new__(cls, *args, **kwargs):
+    def __new__(
+        cls,
+        *args,
+        **kwargs
+    ) -> 'Container':
         """
         Creates and returns a singleton instance of the class.
 
@@ -52,24 +57,29 @@ class Container:
                     cls._instance = super(Container, cls).__new__(cls)
         return cls._instance
 
-    def __init__(self):
+    def __init__(
+        self
+    ) -> None:
         """
         Initializes a new instance of the container.
 
         This constructor sets up the internal dictionaries for bindings and aliases,
         ensuring that these are only initialized once per class. The initialization
         is guarded by the `_initialized` class attribute to prevent redundant setup.
+        The container also registers itself as a service to allow for injection.
 
         Notes
         -----
         - The `__bindings` dictionary is used to store service bindings.
         - The `__aliasses` dictionary is used to store service aliases.
         - Initialization occurs only once per class, regardless of the number of instances.
+        - The container registers itself under the IContainer interface to allow for dependency injection.
         """
         if not self.__class__._initialized:
             self.__bindings = {}
             self.__aliasses = {}
             self.__class__._initialized = True
+            self.instance(IContainer, self)
 
     def __dropService(
         self,
@@ -380,6 +390,48 @@ class Container:
                 "Please ensure that all abstract methods are implemented."
             )
 
+    def __getService(
+        self,
+        abstract_or_alias: Any
+    ) -> Binding:
+        """
+        Retrieves the binding for the requested abstract type or alias.
+
+        Parameters
+        ----------
+        abstract_or_alias : Any
+            The abstract class, interface, or alias (str) to retrieve.
+
+        Returns
+        -------
+        Binding
+            The binding associated with the requested abstract type or alias.
+        """
+        return self.__bindings.get(abstract_or_alias) or self.__aliasses.get(abstract_or_alias)
+
+    def __getFirstService(
+        self,
+        abstract_or_aliasses: list
+    ) -> Binding:
+        """
+        Retrieves the first binding from a list of abstract types or aliases.
+
+        Parameters
+        ----------
+        abstract_or_aliasses : list
+            A list of abstract classes, interfaces, or aliases (str) to retrieve.
+
+        Returns
+        -------
+        Binding
+            The first binding found in the container for the provided abstract types or aliases.
+        """
+        for item in abstract_or_aliasses:
+            binding = self.__getService(item)
+            if binding:
+                return binding
+        return None
+
     def transient(
         self,
         abstract: Callable[..., Any],
@@ -716,7 +768,7 @@ class Container:
     def function(
         self,
         alias: str,
-        function: Callable[..., Any],
+        fn: Callable[..., Any],
         *,
         lifetime: Lifetime = Lifetime.TRANSIENT
     ) -> bool:
@@ -727,7 +779,7 @@ class Container:
         ----------
         alias : str
             The alias to register the function under.
-        function : Callable[..., Any]
+        fn : Callable[..., Any]
             The function or factory to register.
         lifetime : Lifetime, optional
             The lifetime of the function registration (default is TRANSIENT).
@@ -764,10 +816,10 @@ class Container:
         self.__ensureAliasType(alias)
 
         # Validate that the function is callable
-        self.__ensureIsCallable(function)
+        self.__ensureIsCallable(fn)
 
         # Inspect the function signature
-        params = ReflectionCallable(function).getDependencies()
+        params = ReflectionCallable(fn).getDependencies()
 
         # If the function requires arguments, only allow TRANSIENT
         if (len(params.resolved) + len(params.unresolved)) > 0 and lifetime != Lifetime.TRANSIENT:
@@ -780,7 +832,7 @@ class Container:
 
         # Register the function with the specified alias and lifetime
         self.__bindings[alias] = Binding(
-            function=function,
+            function=fn,
             lifetime=lifetime,
             alias=alias
         )
@@ -820,8 +872,8 @@ class Container:
     def make(
         self,
         abstract_or_alias: Any,
-        *args,
-        **kwargs
+        *args: tuple,
+        **kwargs: dict
     ) -> Any:
         """
         Resolves and returns an instance of the requested service.
@@ -845,11 +897,341 @@ class Container:
         OrionisContainerException
             If the requested service is not registered in the container.
         """
-        if not self.bound(abstract_or_alias):
+        # Retrieve the binding for the requested abstract or alias
+        binding = self.__getService(abstract_or_alias)
+
+        # Check if the requested service is registered in the container
+        if not binding:
             raise OrionisContainerException(
                 f"The requested service '{abstract_or_alias}' is not registered in the container."
             )
 
-        binding = self.__bindings.get(abstract_or_alias) or self.__aliasses.get(abstract_or_alias)
+        # Handle based on binding type and lifetime
+        if binding.lifetime == Lifetime.TRANSIENT:
+            return self.__resolveTransient(binding, *args, **kwargs)
+        elif binding.lifetime == Lifetime.SINGLETON:
+            return self.__resolveSingleton(binding, *args, **kwargs)
+        elif binding.lifetime == Lifetime.SCOPED:
+            # TODO: Implement scoped lifetime resolution
+            raise OrionisContainerException(
+                "Scoped lifetime resolution is not yet implemented."
+            )
+
+    def __resolveTransient(self, binding: Binding, *args, **kwargs) -> Any:
+        """
+        Resolves a service with transient lifetime.
+
+        Parameters
+        ----------
+        binding : Binding
+            The binding to resolve.
+        *args : tuple
+            Positional arguments to pass to the constructor.
+        **kwargs : dict
+            Keyword arguments to pass to the constructor.
+
+        Returns
+        -------
+        Any
+            A new instance of the requested service.
+        """
+
+        # Check if the binding has a concrete class or function defined
+        if binding.concrete:
+            if args or kwargs:
+                return self.__instantiateConcreteWithArgs(binding.concrete, *args, **kwargs)
+            else:
+                return self.__instantiateConcreteReflective(binding.concrete)
+
+        # If the binding has a function defined
+        elif binding.function:
+            if args or kwargs:
+                return self.__instantiateCallableWithArgs(binding.function, *args, **kwargs)
+            else:
+                return self.__instantiateCallableReflective(binding.function)
+
+        # If neither concrete class nor function is defined
+        else:
+            raise OrionisContainerException(
+                "Cannot resolve transient binding: neither a concrete class nor a function is defined."
+            )
+
+    def __resolveSingleton(self, binding: Binding, *args, **kwargs) -> Any:
+        """
+        Resolves a service with singleton lifetime.
+
+        Parameters
+        ----------
+        binding : Binding
+            The binding to resolve.
+        *args : tuple
+            Positional arguments to pass to the constructor (only used if instance doesn't exist yet).
+        **kwargs : dict
+            Keyword arguments to pass to the constructor (only used if instance doesn't exist yet).
+
+        Returns
+        -------
+        Any
+            The singleton instance of the requested service.
+        """
+        # Return existing instance if available
+        if binding.instance:
+            return binding.instance
+
+        # Create instance if needed
+        if binding.concrete:
+            if args or kwargs:
+                binding.instance = self.__instantiateConcreteWithArgs(binding.concrete, *args, **kwargs)
+            else:
+                binding.instance = self.__instantiateConcreteReflective(binding.concrete)
+            return binding.instance
+
+        # If the binding has a function defined
+        elif binding.function:
+            if args or kwargs:
+                result = self.__instantiateCallableWithArgs(binding.function, *args, **kwargs)
+            else:
+                result = self.__instantiateCallableReflective(binding.function)
+
+            # Store the result directly as the singleton instance
+            # We don't automatically invoke factory function results anymore
+            binding.instance = result
+            return binding.instance
+
+        # If neither concrete class nor function is defined
+        else:
+            raise OrionisContainerException(
+                "Cannot resolve singleton binding: neither a concrete class, instance, nor function is defined."
+            )
+
+    def __instantiateConcreteWithArgs(self, concrete: Callable[..., Any], *args, **kwargs) -> Any:
+        """
+        Instantiates a concrete class with the provided arguments.
+
+        Parameters
+        ----------
+        concrete : Callable[..., Any]
+            Class to instantiate.
+        *args : tuple
+            Positional arguments to pass to the constructor.
+        **kwargs : dict
+            Keyword arguments to pass to the constructor.
 
-        print(binding)
+        Returns
+        -------
+        object
+            A new instance of the specified concrete class.
+        """
+
+        # try to instantiate the concrete class with the provided arguments
+        try:
+
+            # If the concrete is a class, instantiate it directly
+            return concrete(*args, **kwargs)
+
+        except TypeError as e:
+
+            # If instantiation fails, use ReflectionConcrete to get class name and constructor signature
+            rf_concrete = ReflectionConcrete(concrete)
+            class_name = rf_concrete.getClassName()
+            signature = rf_concrete.getConstructorSignature()
+
+            # Raise an exception with detailed information about the failure
+            raise OrionisContainerException(
+                f"Failed to instantiate [{class_name}] with the provided arguments: {e}\n"
+                f"Expected constructor signature: [{signature}]"
+            ) from e
+
+    def __instantiateCallableWithArgs(self, fn: Callable[..., Any], *args, **kwargs) -> Any:
+        """
+        Invokes a callable with the provided arguments.
+
+        Parameters
+        ----------
+        fn : Callable[..., Any]
+            The callable to invoke.
+        *args : tuple
+            Positional arguments to pass to the callable.
+        **kwargs : dict
+            Keyword arguments to pass to the callable.
+
+        Returns
+        -------
+        Any
+            The result of the callable.
+        """
+
+        # Try to invoke the callable with the provided arguments
+        try:
+
+            # If the callable is a function, invoke it directly
+            return fn(*args, **kwargs)
+
+        except TypeError as e:
+
+            # If invocation fails, use ReflectionCallable to get function name and signature
+            rf_callable = ReflectionCallable(fn)
+            function_name = rf_callable.getName()
+            signature = rf_callable.getSignature()
+
+            # Raise an exception with detailed information about the failure
+            raise OrionisContainerException(
+                f"Failed to invoke function [{function_name}] with the provided arguments: {e}\n"
+                f"Expected function signature: [{signature}]"
+            ) from e
+
+    def __instantiateConcreteReflective(self, concrete: Callable[..., Any]) -> Any:
+        """
+        Instantiates a concrete class reflectively, resolving its dependencies from the container.
+
+        Parameters
+        ----------
+        concrete : Callable[..., Any]
+            The concrete class to instantiate.
+
+        Returns
+        -------
+        Any
+            A new instance of the concrete class.
+        """
+        # Resolve dependencies for the concrete class
+        params = self.__resolveDependencies(concrete, is_class=True)
+
+        # Instantiate the concrete class with resolved dependencies
+        return concrete(**params)
+
+    def __instantiateCallableReflective(self, fn: Callable[..., Any]) -> Any:
+        """
+        Invokes a callable reflectively, resolving its dependencies from the container.
+
+        Parameters
+        ----------
+        fn : Callable[..., Any]
+            The callable to invoke.
+
+        Returns
+        -------
+        Any
+            The result of the callable.
+        """
+
+        # Resolve dependencies for the callable
+        params = self.__resolveDependencies(fn, is_class=False)
+
+        # Invoke the callable with resolved dependencies
+        return fn(**params)
+
+    def __resolveDependencies(
+        self,
+        target: Callable[..., Any],
+        *,
+        is_class: bool = False
+    ) -> dict:
+        """
+        Resolves dependencies for a target callable or class.
+
+        Parameters
+        ----------
+        target : Callable[..., Any]
+            The target callable or class whose dependencies to resolve.
+        is_class : bool, optional
+            Whether the target is a class (True) or a callable (False).
+
+        Returns
+        -------
+        dict
+            A dictionary of resolved dependencies.
+        """
+        try:
+
+            # Use ReflectionConcrete for classes and ReflectionCallable for callables
+            if is_class:
+                reflection = ReflectionConcrete(target)
+                dependencies = reflection.getConstructorDependencies()
+                name = reflection.getClassName()
+
+            # If the target is a callable, use ReflectionCallable
+            else:
+                reflection = ReflectionCallable(target)
+                dependencies = reflection.getDependencies()
+                name = reflection.getName()
+
+            # Check for unresolved dependencies
+            if dependencies.unresolved:
+                unresolved_args = ', '.join(dependencies.unresolved)
+                raise OrionisContainerException(
+                    f"Cannot resolve '{name}' because the following required arguments are missing: [{unresolved_args}]."
+                )
+
+            # Resolve dependencies
+            params = {}
+            for param_name, dep in dependencies.resolved.items():
+
+                # If the dependency is a ResolvedDependency, resolve it
+                if isinstance(dep, ResolvedDependency):
+
+                    # If the dependency is a built-in type, raise an exception
+                    if dep.module_name == 'builtins':
+                        raise OrionisContainerException(
+                            f"Cannot resolve '{name}' because parameter '{param_name}' depends on built-in type '{dep.type.__name__}'."
+                        )
+
+                    # Try to resolve from container
+                    service = self.__getFirstService([dep.type, dep.full_class_path])
+                    if service:
+                        params[param_name] = self.make(service.alias)
+
+                    # Try to instantiate directly if it's a concrete class
+                    elif ReflectionConcrete.isConcreteClass(dep.type):
+                        params[param_name] = dep.type(**self.__resolveDependencies(dep.type, is_class=True))
+
+                    # Try to call directly if it's a callable
+                    elif callable(dep.type) and not isinstance(dep.type, type):
+                        params[param_name] = dep.type(**self.__resolveDependencies(dep.type, is_class=False))
+
+                    # If the dependency cannot be resolved, raise an exception
+                    else:
+                        raise OrionisContainerException(
+                            f"Cannot resolve dependency '{param_name}' of type '{dep.type.__name__}' for '{name}'."
+                        )
+                else:
+                    # Use default value
+                    params[param_name] = dep
+
+            # Return the resolved parameters
+            return params
+
+        except ImportError as e:
+
+            # Extract module name from the error message if possible
+            import_msg = str(e)
+            module_name = target.__module__ if hasattr(target, '__module__') else "unknown module"
+
+            # Check for potential circular import patterns
+            if "circular import" in import_msg.lower() or "cannot import name" in import_msg.lower():
+                raise OrionisContainerException(
+                    f"Circular import detected while resolving dependencies for '{target.__name__}' in module '{module_name}'.\n"
+                    f"This typically happens when two modules import each other. Consider:\n"
+                    f"1. Restructuring your code to avoid circular dependencies\n"
+                    f"2. Using delayed imports inside methods rather than at module level\n"
+                    f"3. Using dependency injection to break the cycle\n"
+                    f"Original error: {import_msg}"
+                ) from e
+            else:
+                raise OrionisContainerException(
+                    f"Import error while resolving dependencies for '{target.__name__}' in module '{module_name}':\n"
+                    f"{import_msg}"
+                ) from e
+
+        except Exception as e:
+
+            # Get more context about where the error occurred
+            target_type = "class" if isinstance(target, type) else "function"
+            target_name = target.__name__ if hasattr(target, '__name__') else str(target)
+            module_name = target.__module__ if hasattr(target, '__module__') else "unknown module"
+
+            raise OrionisContainerException(
+                f"Error resolving dependencies for {target_type} '{target_name}' in '{module_name}':\n"
+                f"{str(e)}\n"
+                f"Check that all dependencies are properly registered in the container."
+            ) from e

orionis/container/contracts/container.py

@@ -0,0 +1,202 @@
+from abc import ABC, abstractmethod
+from typing import Any, Callable
+from orionis.container.enums.lifetimes import Lifetime
+
+class IContainer(ABC):
+    """
+    IContainer is an interface that defines the structure for a dependency injection container.
+    It provides methods for registering and resolving services with different lifetimes.
+    """
+
+    @abstractmethod
+    def singleton(
+        self,
+        abstract: Callable[..., Any],
+        concrete: Callable[..., Any],
+        *,
+        alias: str = None,
+        enforce_decoupling: bool = False
+    ) -> bool:
+        """
+        Register a service as a singleton.
+
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract base type or interface to be bound.
+        concrete : Callable[..., Any]
+            The concrete implementation to associate with the abstract type.
+        alias : str, optional
+            An alternative name to register the service under.
+        enforce_decoupling : bool, optional
+            Whether to enforce that concrete is not a subclass of abstract.
+
+        Returns
+        -------
+        bool
+            True if the service was registered successfully.
+        """
+        pass
+
+    @abstractmethod
+    def transient(
+        self,
+        abstract: Callable[..., Any],
+        concrete: Callable[..., Any],
+        *,
+        alias: str = None,
+        enforce_decoupling: bool = False
+    ) -> bool:
+        """
+        Register a service as transient.
+
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract base type or interface to be bound.
+        concrete : Callable[..., Any]
+            The concrete implementation to associate with the abstract type.
+        alias : str, optional
+            An alternative name to register the service under.
+        enforce_decoupling : bool, optional
+            Whether to enforce that concrete is not a subclass of abstract.
+
+        Returns
+        -------
+        bool
+            True if the service was registered successfully.
+        """
+        pass
+
+    @abstractmethod
+    def scoped(
+        self,
+        abstract: Callable[..., Any],
+        concrete: Callable[..., Any],
+        *,
+        alias: str = None,
+        enforce_decoupling: bool = False
+    ) -> bool:
+        """
+        Register a service as scoped.
+
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract base type or interface to be bound.
+        concrete : Callable[..., Any]
+            The concrete implementation to associate with the abstract type.
+        alias : str, optional
+            An alternative name to register the service under.
+        enforce_decoupling : bool, optional
+            Whether to enforce that concrete is not a subclass of abstract.
+
+        Returns
+        -------
+        bool
+            True if the service was registered successfully.
+        """
+        pass
+
+    @abstractmethod
+    def instance(
+        self,
+        abstract: Callable[..., Any],
+        instance: Any,
+        *,
+        alias: str = None,
+        enforce_decoupling: bool = False
+    ) -> bool:
+        """
+        Register an instance of a service.
+
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract class or interface to associate with the instance.
+        instance : Any
+            The concrete instance to register.
+        alias : str, optional
+            An optional alias to register the instance under.
+        enforce_decoupling : bool, optional
+            Whether to enforce that instance's class is not a subclass of abstract.
+
+        Returns
+        -------
+        bool
+            True if the instance was successfully registered.
+        """
+        pass
+
+    @abstractmethod
+    def function(
+        self,
+        alias: str,
+        fn: Callable[..., Any],
+        *,
+        lifetime: Lifetime = Lifetime.TRANSIENT
+    ) -> bool:
+        """
+        Register a function as a service.
+
+        Parameters
+        ----------
+        alias : str
+            The alias to register the function under.
+        fn : Callable[..., Any]
+            The function or factory to register.
+        lifetime : Lifetime, optional
+            The lifetime of the function registration (default is TRANSIENT).
+
+        Returns
+        -------
+        bool
+            True if the function was registered successfully.
+        """
+        pass
+
+    @abstractmethod
+    def make(
+        self,
+        abstract_or_alias: Any,
+        *args: tuple,
+        **kwargs: dict
+    ) -> Any:
+        """
+        Resolve a service from the container.
+
+        Parameters
+        ----------
+        abstract_or_alias : Any
+            The abstract class, interface, or alias (str) to resolve.
+        *args : tuple
+            Positional arguments to pass to the constructor.
+        **kwargs : dict
+            Keyword arguments to pass to the constructor.
+
+        Returns
+        -------
+        Any
+            An instance of the requested service.
+        """
+        pass
+
+    @abstractmethod
+    def bound(
+        self,
+        abstract_or_alias: Any
+    ) -> bool:
+        """
+        Check if a service is registered in the container.
+
+        Parameters
+        ----------
+        abstract_or_alias : Any
+            The abstract class, interface, or alias (str) to check.
+
+        Returns
+        -------
+        bool
+            True if the service is registered, False otherwise.
+        """
+        pass

orionis/metadata/framework.py

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

orionis/services/introspection/callables/reflection_callable.py

@@ -1,10 +1,9 @@
 import inspect
 from orionis.services.asynchrony.coroutines import Coroutine
-from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency as CallableDependency
+from orionis.services.introspection.dependencies.entities.callable_dependencies import CallableDependency
 from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies
 from orionis.services.introspection.exceptions.reflection_attribute_error import ReflectionAttributeError
 from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
-import asyncio
 
 class ReflectionCallable:
 
@@ -131,6 +130,20 @@ class ReflectionCallable:
             return Coroutine(self.__function(*args, **kwargs)).run()
         return self.__function(*args, **kwargs)
 
+    def getSignature(self) -> inspect.Signature:
+        """
+        Retrieve the signature of the callable function.
+        Returns
+        -------
+        inspect.Signature
+            An `inspect.Signature` object representing the callable's signature.
+        Notes
+        -----
+        This method provides detailed information about the parameters of the callable,
+        including their names, default values, and annotations.
+        """
+        return inspect.signature(self.__function)
+
     def getDependencies(self) -> CallableDependency:
         """
         Analyzes the callable associated with this instance and retrieves its dependencies.

orionis/services/introspection/concretes/reflection_concrete.py

@@ -1442,6 +1442,17 @@ class ReflectionConcrete(IReflectionConcrete):
 
         return prop.fget.__doc__ if prop.fget else None
 
+    def getConstructorSignature(self) -> inspect.Signature:
+        """
+        Get the signature of the constructor of the instance's class.
+
+        Returns
+        -------
+        inspect.Signature
+            The signature of the constructor
+        """
+        return inspect.signature(self._concrete.__init__)
+
     def getConstructorDependencies(self) -> ClassDependency:
         """
         Get the resolved and unresolved dependencies from the constructor of the instance's class.

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

@@ -0,0 +1,55 @@
+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 CallableDependency:
+    """
+    Represents the dependencies of a callable, separating resolved and unresolved dependencies.
+
+    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]
+
+    def __post_init__(self):
+        """
+        Validates types and values of attributes during initialization.
+
+        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
+        """
+        # Validate 'resolved' is a dict with proper key types
+        if not isinstance(self.resolved, dict):
+            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 ReflectionTypeError(
+                f"'unresolved' must be a list, got {type(self.unresolved).__name__}"
+            )

orionis/services/introspection/dependencies/reflect_dependencies.py

@@ -1,6 +1,7 @@
 import inspect
 from typing import Any, Dict, List
 from orionis.services.introspection.contracts.reflect_dependencies import IReflectDependencies
+from orionis.services.introspection.dependencies.entities.callable_dependencies import CallableDependency
 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
@@ -176,7 +177,7 @@ class ReflectDependencies(IReflectDependencies):
             unresolved=unresolved_dependencies
         )
 
-    def getCallableDependencies(self, fn: callable) -> MethodDependency:
+    def getCallableDependencies(self, fn: callable) -> CallableDependency:
         """
         Get the resolved and unresolved dependencies from a callable function.
 
@@ -222,7 +223,7 @@ class ReflectDependencies(IReflectDependencies):
                     full_class_path=f"{module_path}.{param.annotation.__name__}"
                 )
 
-        return MethodDependency(
+        return CallableDependency(
             resolved=resolved_dependencies,
             unresolved=unresolved_dependencies
         )

{orionis-0.317.0.dist-info → orionis-0.319.0.dist-info}/METADATA

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

{orionis-0.317.0.dist-info → orionis-0.319.0.dist-info}/RECORD

@@ -135,7 +135,8 @@ orionis/console/output/console.py,sha256=TE_Hl720ADd82dbERFSWhkoQRukDQZmETSw4nkw
 orionis/console/output/executor.py,sha256=bdvkzW2-buy0BPpy2r5qUGrRFW2Ay6k-5rSeHb0gQ3o,3352
 orionis/console/output/progress_bar.py,sha256=vFy582z6VJS46LV6tuyrmr9qvdVeTEtw3hyNcEHezeg,3088
 orionis/console/output/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
-orionis/container/container.py,sha256=BPBO0i1EgL-9g9sgDotrInM2UiuDMT7TNDRHDdrQCZo,30121
+orionis/container/container.py,sha256=ZL3S0HyAt8Hm58dPjltNMCSMNNP30VR61ByslzmCGgs,45066
+orionis/container/contracts/container.py,sha256=LkZ5til_3Um8ctCVTwuO36HkysL59saKwUzXR5cWUBs,5750
 orionis/container/entities/binding.py,sha256=Qp6Lf4XUDp2NjqXDAC2lzvhOFQWiBDKiGFcKfwb4axw,4342
 orionis/container/enums/lifetimes.py,sha256=RqQmugMIB1Ev_j_vFLcWorndm-to7xg4stQ7yKFDdDw,190
 orionis/container/exceptions/container_exception.py,sha256=goTDEwC70xTMD2qppN8KV-xyR0Nps218OD4D1LZ2-3s,470
@@ -232,7 +233,7 @@ orionis/foundation/contracts/config.py,sha256=Rpz6U6t8OXHO9JJKSTnCimytXE-tfCB-1i
 orionis/foundation/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/exceptions/integrity.py,sha256=mc4pL1UMoYRHEmphnpW2oGk5URhu7DJRREyzHaV-cs8,472
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=IhaXribsZwgUQ1ZD4sXOCEanSM6ZfeiOASiDyOpzViA,4960
+orionis/metadata/framework.py,sha256=MyXQ31_zvD5irlN_XvuSicVccDNBPb64XCKc8qujCEc,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
@@ -259,9 +260,9 @@ orionis/services/introspection/reflection.py,sha256=6z4VkDICohMIkm9jEd7nmFABwVuU
 orionis/services/introspection/abstract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/abstract/reflection_abstract.py,sha256=SPK2X11VvGORxxPOYloaD6hPAvky--obRU4CO1DE4zM,43865
 orionis/services/introspection/callables/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/callables/reflection_callable.py,sha256=AWTw9T9DGpCscwvrqYtYAYdTeoJqIHzdRDS29Sb5cSI,5667
+orionis/services/introspection/callables/reflection_callable.py,sha256=0B2B6ZV-ql_aZk97W4Q12MVvi0gwErjekgWaMBxjfV0,6147
 orionis/services/introspection/concretes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/concretes/reflection_concrete.py,sha256=1GxD-y8LPGL6kI4Y3XbeLcFjR5Y8cOqbVEPCtPnsuYA,50982
+orionis/services/introspection/concretes/reflection_concrete.py,sha256=SdE2IWEgt30eO9-f_VRNdIZ_OWWidauQzQZQVrXjcXY,51310
 orionis/services/introspection/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/contracts/reflect_dependencies.py,sha256=5fdImZarC1ixoFM-1JSBx28RvYbY3GGZhDGjar7cvHc,1771
 orionis/services/introspection/contracts/reflection_abstract.py,sha256=-ugpFcAkGTlk0Md5ft8NrvupnlfVji8QZjGYqWBxqeY,22370
@@ -269,8 +270,9 @@ orionis/services/introspection/contracts/reflection_concrete.py,sha256=9ZQjJpZwv
 orionis/services/introspection/contracts/reflection_instance.py,sha256=D9sH-uOSZ_E7luAfbjI_ML6kfxuO5MtvLk6037iQJ7o,20936
 orionis/services/introspection/contracts/reflection_module.py,sha256=YLqKg5EhaddUBrytMHX1-uz9mNsRISK1iVyG_iUiVYA,9666
 orionis/services/introspection/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/dependencies/reflect_dependencies.py,sha256=xjY9RRBbALfifoefUuHu2EU5XUNdV9zKFaJ9-x7TP2I,9303
+orionis/services/introspection/dependencies/reflect_dependencies.py,sha256=OXMfWqacFM7Mo5y0zmPprP4ECHqImChDFsfzTyhqS9A,9414
 orionis/services/introspection/dependencies/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/services/introspection/dependencies/entities/callable_dependencies.py,sha256=GJPS1pO8aIhYjtYw7bEoV8WfUCn-ZPGt5mD1WvfoAxg,2198
 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
@@ -343,7 +345,7 @@ orionis/test/suite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuF
 orionis/test/suite/test_unit.py,sha256=MWgW8dRCRyT1XZ5LsbXQ7-KVPReasoXwzEEL1EWWfE4,52190
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=jXZkbITBknbUwm_mD8bcTiwLDvsFkrO9qrf0ZgPwqxc,4903
-orionis-0.317.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.319.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=kvWgiW3ADEZf718dGsMPtDh_rmOSx1ypEInKm7_6ZPQ,601
@@ -414,14 +416,14 @@ tests/services/environment/test_services_environment.py,sha256=fdkjwbY-aDEA1FT-9
 tests/services/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/inspection/test_reflection.py,sha256=ZApQeaDxYLsrfGN6UqEDPbyNzocMV9CURflQ35YMfqk,13678
 tests/services/inspection/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/services/inspection/dependencies/test_reflect_dependencies.py,sha256=xjcbfWlCT-QuI0wDgXbbsfvWG5phvrvPcfMOwmUnpHQ,7279
+tests/services/inspection/dependencies/test_reflect_dependencies.py,sha256=s_P4ST_dmjzRKmUL4bPFs-oR-Mf5PENGmYk56WiGO9g,7388
 tests/services/inspection/dependencies/mocks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/inspection/dependencies/mocks/mock_user.py,sha256=RxATxe0-Vm4HfX5jKz9Tny42E2fmrdtEN6ZEntbqRL8,912
 tests/services/inspection/dependencies/mocks/mock_user_controller.py,sha256=P3sOUXVZ55auudwiNtvNCEQuTz0cgAZjvhicLZ4xaz4,1208
 tests/services/inspection/dependencies/mocks/mock_users_permissions.py,sha256=oENXbS2qmQUudYSmnhB8fgHBqXZdbplplB-Y2nbx4hw,1388
 tests/services/inspection/reflection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/inspection/reflection/test_reflection_abstract.py,sha256=MbGDfCDkfj8wVJcyAlwV6na98JLzbGaYa3QjXR1alL8,27395
-tests/services/inspection/reflection/test_reflection_callable.py,sha256=GBZL9oIwfBDfhQ3VXVrZDkdwoTkymMqLfFQSBCSs8pE,7021
+tests/services/inspection/reflection/test_reflection_callable.py,sha256=ZcZ1_v4Nv22gIleflCRzE0Kfwy5Kjj8XjZ9Z1cKdXt8,6855
 tests/services/inspection/reflection/test_reflection_concrete.py,sha256=5-iQh1whfpBa47jBWwtg-MIk6ysg92my5J9JdrTBm5E,44622
 tests/services/inspection/reflection/test_reflection_instance.py,sha256=ZCFTLY_KtLAIq58PuDWak-T1c2PcCKiwTOdI9EDubww,46281
 tests/services/inspection/reflection/test_reflection_module.py,sha256=Cl-3kWoJMQ2ufOO4VP6M28Tk6kmY4OhVEoW_b0wqw7Y,19849
@@ -444,8 +446,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=yeVwl-VcwkWSQYyxZu
 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=DjLBtvVn8B1KlVJNNkstBT8_csA1yeaMqnGrbanN_J4,7438
-orionis-0.317.0.dist-info/METADATA,sha256=ArEDpHbIszs0kFP63nOxlOuuEJygJsbjqGR8xCRQ9gM,4772
-orionis-0.317.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.317.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.317.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.317.0.dist-info/RECORD,,
+orionis-0.319.0.dist-info/METADATA,sha256=426gql1AFezl4n3-_ORGM8wdkUYcEsZr8n3ykl6ruOI,4772
+orionis-0.319.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.319.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.319.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.319.0.dist-info/RECORD,,

tests/services/inspection/dependencies/test_reflect_dependencies.py

@@ -1,4 +1,5 @@
 import asyncio
+from orionis.services.introspection.dependencies.entities.callable_dependencies import CallableDependency
 from orionis.services.introspection.dependencies.reflect_dependencies import (
     ReflectDependencies,
     ClassDependency,
@@ -113,7 +114,7 @@ class TestReflectDependencies(TestCase):
         callable_dependencies = depend.getCallableDependencies(fake_function)
 
         # Check Instance of MethodDependency
-        self.assertIsInstance(callable_dependencies, MethodDependency)
+        self.assertIsInstance(callable_dependencies, CallableDependency)
 
         # Check unresolved dependencies
         self.assertEqual(callable_dependencies.unresolved, [])

tests/services/inspection/reflection/test_reflection_callable.py

@@ -1,9 +1,7 @@
 from orionis.services.introspection.callables.reflection_callable import ReflectionCallable
+from orionis.services.introspection.dependencies.entities.callable_dependencies import CallableDependency
 from orionis.unittesting import TestCase
 from orionis.services.introspection.exceptions.reflection_type_error import ReflectionTypeError
-from orionis.services.introspection.exceptions.reflection_attribute_error import ReflectionAttributeError
-from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency as CallableDependency
-from orionis.services.introspection.dependencies.reflect_dependencies import ReflectDependencies
 
 class TestReflectionCallable(TestCase):
 
@@ -153,5 +151,6 @@ class TestReflectionCallable(TestCase):
             return a + b
         rc = ReflectionCallable(sample_function)
         deps = rc.getDependencies()
+        self.assertIsInstance(deps, CallableDependency)
         self.assertTrue(hasattr(deps, "resolved"))
         self.assertTrue(hasattr(deps, "unresolved"))