orionis 0.324.0__tar.gz → 0.326.0__tar.gz

{orionis-0.324.0/orionis.egg-info → orionis-0.326.0}/PKG-INFO

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

orionis-0.326.0/orionis/container/exceptions/attribute_error.py

@@ -0,0 +1,19 @@
+class OrionisContainerAttributeError(AttributeError):
+
+    def __init__(self, msg: str):
+        """
+        Parameters
+        ----------
+        msg : str
+            Descriptive error message explaining the cause of the exception.
+        """
+        super().__init__(msg)
+
+    def __str__(self) -> str:
+        """
+        Returns
+        -------
+        str
+            Formatted string describing the exception.
+        """
+        return str(self.args[0])

orionis-0.326.0/orionis/container/facades/facade.py

@@ -0,0 +1,92 @@
+from typing import Any
+from orionis.container.container import Container
+from orionis.container.exceptions.attribute_error import OrionisContainerAttributeError
+from orionis.container.exceptions.container_exception import OrionisContainerException
+
+class FacadeMeta(type):
+
+    def __getattr__(cls, name: str) -> Any:
+        """
+        When an undefined attribute is accessed, this method resolves the service and delegates the call.
+
+        Parameters
+        ----------
+        name : str
+            The name of the attribute to access
+
+        Returns
+        -------
+        Any
+            The requested attribute from the underlying service
+
+        Raises
+        ------
+        OrionisContainerAttributeError
+            If the resolved service does not have the requested attribute
+        """
+        service = cls.resolve()
+        if not hasattr(service, name):
+            raise OrionisContainerAttributeError(f"'{cls.__name__}' facade's service has no attribute '{name}'")
+        return getattr(service, name)
+
+class Facade(metaclass=FacadeMeta):
+
+    # Container instance to resolve services
+    _container = Container()
+
+    @classmethod
+    def getFacadeAccessor(cls) -> str:
+        """
+        Get the name of the service to be resolved from the container.
+        This method must be overridden by subclasses to return the name of the service
+        to be resolved. If not overridden, it raises NotImplementedError.
+        Returns
+        -------
+        str
+            The service name to be resolved from the container.
+        Raises
+        ------
+        NotImplementedError
+            If the method is not overridden by a subclass.
+        """
+        raise NotImplementedError(f"Class {cls.__name__} must define the getFacadeAccessor method")
+
+    @classmethod
+    def resolve(cls, *args, **kwargs) -> Any:
+        """
+        This method retrieves a service instance from the container using the facade accessor.
+        If the service is not bound in the container, a RuntimeError is raised.
+        Parameters
+        ----------
+        *args
+            Positional arguments to pass to the service constructor.
+        **kwargs
+            Keyword arguments to pass to the service constructor.
+
+        Returns
+        -------
+        Any
+            The resolved service instance.
+
+        Raises
+        ------
+        OrionisContainerException
+            If the service is not bound in the container.
+        Notes
+        -----
+        """
+
+        # Get the service name from the facade accessor
+        service_name = cls.getFacadeAccessor()
+
+        # Check if the service is bound in the container
+        if not cls._container.bound(service_name):
+            raise OrionisContainerException(
+                f"Service '{service_name}' not bound in the container. "
+                f"Please ensure '{service_name}' is registered in the container before using the {cls.__name__} facade. "
+                "You can register services in a service provider using the 'register' method."
+            )
+
+        # Resolve the service instance from the container
+        service_instance = cls._container.make(service_name, *args, **kwargs)
+        return service_instance

{orionis-0.324.0 → orionis-0.326.0}/orionis/metadata/framework.py

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

{orionis-0.324.0 → orionis-0.326.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.324.0 → orionis-0.326.0}/orionis.egg-info/SOURCES.txt

@@ -147,6 +147,7 @@ orionis/container/context/scope.py
 orionis/container/contracts/container.py
 orionis/container/entities/binding.py
 orionis/container/enums/lifetimes.py
+orionis/container/exceptions/attribute_error.py
 orionis/container/exceptions/container_exception.py
 orionis/container/exceptions/type_error_exception.py
 orionis/container/exceptions/value_exception.py

orionis-0.324.0/orionis/container/facades/facade.py

@@ -1,60 +0,0 @@
-from typing import Any
-from orionis.container.container import Container
-
-class FacadeMeta(type):
-
-    def __getattr__(cls, name: str) -> Any:
-        """
-        When an undefined attribute is accessed, this method resolves the service and delegates the call.
-        It's like having a genie in a bottle, but for services.
-
-        Args:
-            name: The name of the attribute to access
-
-        Returns:
-            The requested attribute from the underlying service
-        """
-        service = cls.resolve()
-        if not hasattr(service, name):
-            raise AttributeError(f"'{cls.__name__}' facade's service has no attribute '{name}'")
-        return getattr(service, name)
-
-
-class Facade(metaclass=FacadeMeta):
-
-    _container = Container()
-
-    @classmethod
-    def getFacadeAccessor(cls) -> str:
-        """
-        This method must be overridden by subclasses to return the name of the service to be resolved.
-        If not, it throws a tantrum (NotImplementedError).
-
-        Returns:
-            The service name to be resolved from the container
-        """
-        raise NotImplementedError(f"Class {cls.__name__} must define the getFacadeAccessor method")
-
-    @classmethod
-    def resolve(cls) -> Any:
-        """
-        Resolves the service from the Container with caching for improved performance.
-        It's like calling the butler to fetch something from the pantry.
-
-        Returns:
-            The resolved service instance
-        """
-
-        # Get the service name from the facade accessor
-        service_name = cls.getFacadeAccessor()
-
-        # Check if the service is bound in the container
-        if not cls._container.bound(service_name):
-            raise RuntimeError(
-                f"The service '{service_name}' is not bound in the container. "
-                "Did you forget to register it?"
-            )
-
-        # Resolve the service instance from the container
-        service_instance = cls._container.make(service_name)
-        return service_instance