orionis 0.7.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

orionis/framework.py

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

orionis/luminate/container/container.py

@@ -1,8 +1,10 @@
 import inspect
 from typing import Any, Callable
+from orionis.luminate.container.types import Types
+from orionis.luminate.contracts.container.container_interface import IContainer
 from orionis.luminate.container.exception import OrionisContainerException, OrionisContainerValueError
 
-class Container:
+class Container(IContainer):
     """Service container and dependency injection."""
 
     _instance = None
@@ -18,6 +20,8 @@ class Container:
             cls._instance._aliases = {}
             cls._instance._scoped_instances = {}
             cls._instance._conditional_bindings = {}
+            # Initialize the PrimitiveTypes validator
+            cls._instance._primitive_types_validator = Types()
         return cls._instance
 
     def bind(self, abstract: str, concrete: Callable[..., Any]) -> None:
@@ -31,6 +35,10 @@ class Container:
             OrionisContainerException: If the service is already registered.
             TypeError: If the implementation is not a callable or instantiable class.
         """
+
+        # Validate that the abstract name is not a primitive type
+        self._primitiveTypeValidator(abstract)
+
         if self.has(abstract):
             raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
 
@@ -50,6 +58,10 @@ class Container:
             OrionisContainerException: If the service is already registered.
             TypeError: If the implementation is not a callable or instantiable class.
         """
+
+        # Validate that the abstract name is not a primitive type
+        self._primitiveTypeValidator(abstract)
+
         if self.has(abstract):
             raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
 
@@ -69,6 +81,10 @@ class Container:
             OrionisContainerException: If the service is already registered.
             TypeError: If the implementation is not a callable or instantiable class.
         """
+
+        # Validate that the abstract name is not a primitive type
+        self._primitiveTypeValidator(abstract)
+
         if self.has(abstract):
             raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
 
@@ -88,6 +104,10 @@ class Container:
             OrionisContainerException: If the service is already registered.
             TypeError: If the implementation is not a callable or instantiable class.
         """
+
+        # Validate that the abstract name is not a primitive type
+        self._primitiveTypeValidator(abstract)
+
         if self.has(abstract):
             raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
 
@@ -107,6 +127,10 @@ class Container:
             OrionisContainerException: If the instance is already registered.
             ValueError: If the provided instance is of an unexpected or invalid type.
         """
+
+        # Validate that the abstract name is not a primitive type
+        self._primitiveTypeValidator(abstract)
+
         if abstract in self._instances:
             raise OrionisContainerException(f"The instance '{abstract}' is already registered in the container.")
 
@@ -151,6 +175,10 @@ class Container:
             OrionisContainerException: If the original service is not registered.
             ValueError: If the alias is not a valid string or is already in use.
         """
+
+        # Validate that the abstract name is not a primitive type
+        self._primitiveTypeValidator(abstract)
+
         # Validate alias type
         if not isinstance(alias, str) or not alias:
             raise ValueError("The alias must be a non-empty string.")
@@ -214,6 +242,57 @@ class Container:
 
         raise OrionisContainerValueError(f"No definition found for '{abstract}'. Ensure the service is registered.")
 
+    def call(self, instance: Any, method_name: str, **overrides):
+        """Llama a un método del objeto resolviendo automáticamente las dependencias registradas.
+
+        Args:
+            instance (Any): Instancia del objeto en el cual se ejecutará el método.
+            method_name (str): Nombre del método a llamar.
+            **overrides: Argumentos que se deben pasar manualmente en lugar de resolverlos automáticamente.
+
+        Returns:
+            Any: El resultado de ejecutar el método con las dependencias resueltas.
+
+        Raises:
+            AttributeError: Si el método no existe en la instancia.
+        """
+        if not hasattr(instance, method_name):
+            raise AttributeError(f"'{instance.__class__.__name__}' has no method '{method_name}'")
+
+        method = getattr(instance, method_name)
+        signature = inspect.signature(method)
+        dependencies = {}
+
+        for name, param in signature.parameters.items():
+            if name in overrides:
+                dependencies[name] = overrides[name]
+            elif param.annotation != inspect.Parameter.empty:
+                # Check if the type is primitive
+                if isinstance(param.annotation, type):
+                    # It is a primitive type like str, int, etc.
+                    dependencies[name] = param.default if param.default != inspect.Parameter.empty else param.annotation()
+                else:
+                    dependencies[name] = self.make(param.annotation.__name__)
+            elif param.default != inspect.Parameter.empty:
+                dependencies[name] = param.default
+            else:
+                raise OrionisContainerValueError(f"Cannot resolve parameter '{name}' in method '{method_name}'")
+
+        return method(**dependencies)
+
+
+    def _primitiveTypeValidator(self, abstract: str) -> None:
+        """Validates that the abstract name is not a primitive type.
+
+        Args:
+            abstract (str): Name of the service to validate.
+
+        Raises:
+            OrionisContainerException: If the service name matches a primitive type.
+        """
+        if self._primitive_types_validator.isPrimitive(abstract):
+            raise OrionisContainerException(f"Cannot register a service with a name equal to a primitive type: '{abstract}'.")
+
     def _resolve(self, concrete: Callable[..., Any]):
         """Automatically resolves the dependencies of a service, handling its constructor dependencies.
 
@@ -236,22 +315,37 @@ class Container:
             if len(parameters) == 0 or (len(parameters) == 1 and "self" in parameters):
                 return concrete()
 
+            # Resolve the dependencies of the class constructor
             dependencies = {}
             for name, param in parameters.items():
                 if name == "self" or param.kind in (param.VAR_POSITIONAL, param.VAR_KEYWORD):
                     continue
 
                 param_type = param.annotation
-                if param_type == param.empty:
-                    raise OrionisContainerValueError(f"Parameter type {name} not specified in {concrete.__name__}")
-
-                dep_name = param_type.__name__
 
-                # Conditional resolution of dependencies, if registered
-                if concrete in self._conditional_bindings and dep_name in self._conditional_bindings[concrete]:
-                    dependencies[name] = self.make(self._conditional_bindings[concrete][dep_name])
+                # If the parameter has a default value, use it directly
+                if param_type == param.empty:
+                    if param.default != param.empty:
+                        # Use the default value if available
+                        dependencies[name] = param.default
+                        continue
+                    else:
+                        raise OrionisContainerValueError(f"Parameter type {name} not specified in {concrete.__name__}")
+
+                # If the parameter type is a primitive (str, int, etc.), pass it as is
+                if isinstance(param_type, type):
+                    if param.default != param.empty:
+                        dependencies[name] = param.default if param.default != param.empty else param_type()
+                    else:
+                        dependencies[name] = param_type()  # Provide default value for primitive types if not specified
                 else:
-                    dependencies[name] = self.make(dep_name)
+                    dep_name = param_type.__name__
+
+                    # Conditional resolution of dependencies, if registered
+                    if concrete in self._conditional_bindings and dep_name in self._conditional_bindings[concrete]:
+                        dependencies[name] = self.make(self._conditional_bindings[concrete][dep_name])
+                    else:
+                        dependencies[name] = self.make(dep_name)
 
             return concrete(**dependencies)
 

orionis/luminate/container/types.py

@@ -0,0 +1,25 @@
+from orionis.luminate.contracts.container.types_interface import ITypes
+
+class Types(ITypes):
+    """A class that handles validation of primitive types to prevent registering services with primitive-type names."""
+
+    # A set of common primitive types in Python
+    _primitive_types = {
+        int, float, str, bool, bytes, type(None), complex,
+        list, tuple, dict, set, frozenset,
+        "int", "float", "str", "bool", "bytes", "None", "complex",
+        "list", "tuple", "dict", "set", "frozenset"
+    }
+
+    def isPrimitive(self, name: str) -> None:
+        """Checks if the provided name corresponds to a primitive type.
+
+        Args:
+            name (str): The name of the service or alias to check.
+
+        Raises:
+            OrionisContainerException: If the name matches a primitive type.
+        """
+        if name in self._primitive_types:
+            return True
+        return False

orionis/luminate/contracts/container/container_interface.py

@@ -0,0 +1,152 @@
+from abc import ABC, abstractmethod
+from typing import Any, Callable
+
+class IContainer(ABC):
+    """Service container and dependency injection."""
+
+    @abstractmethod
+    def bind(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service with a specific implementation.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        pass
+
+    @abstractmethod
+    def transient(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service as Transient, creating a new instance on each request.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        pass
+
+    @abstractmethod
+    def singleton(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service as Singleton, ensuring a single shared instance.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        pass
+
+    @abstractmethod
+    def scoped(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service as Scoped, shared within the same request.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        pass
+
+    @abstractmethod
+    def instance(self, abstract: str, instance: Any) -> None:
+        """Registers a specific instance in the container, allowing it to be reused.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            instance (Any): Specific instance of the service to register.
+
+        Raises:
+            OrionisContainerException: If the instance is already registered.
+            ValueError: If the provided instance is of an unexpected or invalid type.
+        """
+        pass
+
+    @abstractmethod
+    def has(self, abstract: str) -> bool:
+        """Checks if a service is registered in the container.
+
+        Args:
+            abstract (str): Name or key of the service to check.
+
+        Returns:
+            bool: True if the service is registered, False otherwise.
+
+        Raises:
+            ValueError: If the service name (abstract) is not a valid string.
+        """
+        pass
+
+    @abstractmethod
+    def alias(self, abstract: str, alias: str) -> None:
+        """Creates an alias for a registered service, allowing access to the service using an alternative name.
+
+        Args:
+            abstract (str): Name or key of the original service.
+            alias (str): The alias to assign to the service.
+
+        Raises:
+            OrionisContainerException: If the original service is not registered.
+            ValueError: If the alias is not a valid string or is already in use.
+        """
+        pass
+
+    @abstractmethod
+    def make(self, abstract: str):
+        """Automatically resolves a dependency, handling instances, singletons, scoped, transients, and aliases.
+
+        This method resolves the dependencies of a service and handles the following service types:
+        1. **Instances**: Returns a specific instance.
+        2. **Singletons**: Returns the same unique instance each time.
+        3. **Scoped**: Returns a shared instance within the same request.
+        4. **Transients**: Creates a new instance each time.
+        5. **Aliases**: Resolves an alias to the original service.
+
+        Args:
+            abstract (str): Name or key of the service to resolve.
+
+        Returns:
+            Any: The resolved instance or service.
+
+        Raises:
+            OrionisContainerException: If the service is not found.
+        """
+        pass
+
+    @abstractmethod
+    def call(self, instance: Any, method_name: str, **overrides):
+        """Llama a un método del objeto resolviendo automáticamente las dependencias registradas.
+
+        Args:
+            instance (Any): Instancia del objeto en el cual se ejecutará el método.
+            method_name (str): Nombre del método a llamar.
+            **overrides: Argumentos que se deben pasar manualmente en lugar de resolverlos automáticamente.
+
+        Returns:
+            Any: El resultado de ejecutar el método con las dependencias resueltas.
+
+        Raises:
+            AttributeError: Si el método no existe en la instancia.
+        """
+        pass
+
+    @abstractmethod
+    def startRequest(self):
+        """Starts a new request and clears the Scoped instances.
+
+        This method should be called at the beginning of each request to ensure that
+        scoped services do not persist between requests.
+        """
+        pass

orionis/luminate/contracts/container/types_interface.py

@@ -0,0 +1,16 @@
+from abc import ABC, abstractmethod
+
+class ITypes(ABC):
+    """A class that handles validation of primitive types to prevent registering services with primitive-type names."""
+
+    @abstractmethod
+    def isPrimitive(self, name: str) -> None:
+        """Checks if the provided name corresponds to a primitive type.
+
+        Args:
+            name (str): The name of the service or alias to check.
+
+        Raises:
+            OrionisContainerException: If the name matches a primitive type.
+        """
+    pass

{orionis-0.7.0.dist-info → orionis-0.9.0.dist-info}/METADATA

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

{orionis-0.7.0.dist-info → orionis-0.9.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=9wNVJxB0HyqUbNesUvkwlsqTyUbZwK6R46iVLE5WVBQ,1715
-orionis/framework.py,sha256=ZiVoL5HQ9nx6oZijIDIPxNNieVtsLT7l2r2Q9zeeBA0,1385
+orionis/framework.py,sha256=BDQNBEtNeZ5JZqepVCR2lQaQu7J3yGdOPT4QZR1RIJU,1385
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/app.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/bootstrap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -52,8 +52,9 @@ orionis/luminate/console/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRk
 orionis/luminate/console/scripts/management.py,sha256=KT6Bg8kyuUw63SNAtZo6tLH6syOEkxM9J70tCpKgrUw,2860
 orionis/luminate/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/tasks/scheduler.py,sha256=h3fRVTx6TuZVcY7zZ6oOzGDnlDAWaRwkj92pFTGUm6E,22686
-orionis/luminate/container/container.py,sha256=Tw_Kibld2dKSomXKQCH-_jn_vAHLXWkbBHRjeSgdwC4,11445
+orionis/luminate/container/container.py,sha256=NB7WpK1-7V-Vhd4ykYH1mU4pqvICZi5U_W7Sdmg1dqc,15652
 orionis/luminate/container/exception.py,sha256=Tf7KdfbEtr0YldhZ1WrKfkBlI5W_KvZO61xWAGFdF0A,1156
+orionis/luminate/container/types.py,sha256=PbPNOJ8e4SGzCmu-zOmCQmDzt1b9I73v3fw_xzLq9RU,932
 orionis/luminate/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/bootstrap/parser_interface.py,sha256=7DLnp7yB7edayVkSm-piTi8JSf0QKaYYI82qDZudgM0,1641
 orionis/luminate/contracts/cache/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -76,6 +77,8 @@ orionis/luminate/contracts/console/register_interface.py,sha256=rhHI_as_3yNWtdgQ
 orionis/luminate/contracts/console/runner_interface.py,sha256=vWLtMhl0m1T6rfCUHZbxGQJl9ZWTXlp3HjcTfCAztGk,1644
 orionis/luminate/contracts/console/schedule_interface.py,sha256=_dsR0gCvJ7_67lwPUAzBwQFHNvWM6jVjcg1EdPqDIIo,10117
 orionis/luminate/contracts/console/task_manager_interface.py,sha256=sOmeifoncpWCG2WYh4q3QZ7M7w7P9Onb3Jxw9X2lpXE,1197
+orionis/luminate/contracts/container/container_interface.py,sha256=Pzvyu5guJkHCxqzHf0Z6JGSLVMwekhrLvccDkPXgC-0,5764
+orionis/luminate/contracts/container/types_interface.py,sha256=GCH7x3PjpXKPET3l84GcXbcM8cpne8AGrmTw-uFaT24,526
 orionis/luminate/contracts/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/facades/env_interface.py,sha256=aN9dZdsuCpy3meZqMxyxLCYlKEIF7XkRNXmP7aS7eCw,1664
 orionis/luminate/contracts/facades/log_interface.py,sha256=EF1sYbjxWdu7-MJMVVG_xxHDbC3JfiMVr1E6DA5WMOk,1294
@@ -133,9 +136,9 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/class_example.py,sha256=dIPD997Y15n6WmKhWoOFSwEldRm9MdOHTZZ49eF1p3c,1056
 tests/tools/test_reflection.py,sha256=dNN5p_xAosyEf0ddAElmmmTfhcTtBd4zBNl7qzgnsc0,5242
-orionis-0.7.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.7.0.dist-info/METADATA,sha256=-wJ-IuY4pOizRCsgyAqcGYLO_fMqeWzuQJkixy4lI1o,2977
-orionis-0.7.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.7.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.7.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.7.0.dist-info/RECORD,,
+orionis-0.9.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.9.0.dist-info/METADATA,sha256=m0yzNERPFenFK381JNLuGbah-nCXAvlgAkX04lYd_Vg,2977
+orionis-0.9.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.9.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.9.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.9.0.dist-info/RECORD,,