orionis 0.325.0__py3-none-any.whl → 0.327.0__py3-none-any.whl

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/container/facades/facade.py

@@ -1,25 +1,34 @@
 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.
-        It's like having a genie in a bottle, but for services.
 
-        Args:
-            name: The name of the attribute to access
+        Parameters
+        ----------
+        name : str
+            The name of the attribute to access
 
-        Returns:
+        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 AttributeError(f"'{cls.__name__}' facade's service has no attribute '{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
@@ -53,13 +62,15 @@ class Facade(metaclass=FacadeMeta):
             Positional arguments to pass to the service constructor.
         **kwargs
             Keyword arguments to pass to the service constructor.
+
         Returns
         -------
         Any
             The resolved service instance.
+
         Raises
         ------
-        RuntimeError
+        OrionisContainerException
             If the service is not bound in the container.
         Notes
         -----
@@ -70,9 +81,10 @@ class Facade(metaclass=FacadeMeta):
 
         # 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?"
+            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

orionis/container/providers/service_provider.py

@@ -0,0 +1,56 @@
+from orionis.container.contracts.container import IContainer
+
+class ServiceProvider:
+    """
+    Base service provider class for the Orionis framework.
+
+    This class serves as a base for all service providers in the application.
+    Service providers are responsible for registering components and services
+    into the application container, and initializing them when needed.
+
+    Parameters
+    ----------
+    app : IContainer
+        The application container instance to which services will be registered.
+
+    Notes
+    -----
+    All concrete service providers should inherit from this class and implement
+    the `register` method at minimum.
+    """
+
+    def __init__(self, app: IContainer) -> None:
+        """
+        Initialize the service provider with the application container.
+
+        Parameters
+        ----------
+        app : IContainer
+            The application container instance.
+        """
+        self.app = app
+
+    def register(self) -> None:
+        """
+        Register services into the application container.
+
+        This method must be implemented by all concrete service providers.
+        It should bind services, configurations, or other components
+        to the application container.
+
+        Raises
+        ------
+        NotImplementedError
+            If the method is not overridden in a subclass.
+        """
+        raise NotImplementedError("This method should be overridden in the subclass")
+
+    def boot(self) -> None:
+        """
+        Perform any post-registration bootstrapping or initialization.
+
+        This method is called after all services have been registered.
+        Override this method to initialize services, set up event listeners,
+        or perform other boot-time operations.
+        """
+        pass

orionis/metadata/framework.py

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

{orionis-0.325.0.dist-info → orionis-0.327.0.dist-info}/METADATA

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

{orionis-0.325.0.dist-info → orionis-0.327.0.dist-info}/RECORD

@@ -137,11 +137,14 @@ orionis/container/context/scope.py,sha256=CWFiLLTAC_IdmeFKWX-jrphdxB0_TMEVBlz6lQ
 orionis/container/contracts/container.py,sha256=hOO3w2yqVhp2nPTeS1uJEYgXSTbM3xwezDCOSNMC_a0,7603
 orionis/container/entities/binding.py,sha256=Qp6Lf4XUDp2NjqXDAC2lzvhOFQWiBDKiGFcKfwb4axw,4342
 orionis/container/enums/lifetimes.py,sha256=RqQmugMIB1Ev_j_vFLcWorndm-to7xg4stQ7yKFDdDw,190
+orionis/container/exceptions/attribute_error.py,sha256=ysYKvXfunH-bywK_e02inY94s8aZ3vUZA6jATbDcQmk,480
 orionis/container/exceptions/container_exception.py,sha256=goTDEwC70xTMD2qppN8KV-xyR0Nps218OD4D1LZ2-3s,470
 orionis/container/exceptions/type_error_exception.py,sha256=cYuvoXVOgRYj3tZPfK341aUERkf33-buOiI2eXxcrAw,470
 orionis/container/exceptions/value_exception.py,sha256=hjY0YEusoL3DurME1ornxvIv1wyGaf6tBggLFlGHblo,472
 orionis/container/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/facades/facade.py,sha256=jY0Np_-fdUofq9cRLTZCYHuE-_Zj-hAhvsg8mhWCaM8,2771
+orionis/container/facades/facade.py,sha256=vu71_uqXnSpCFyeswPgKIhTPmIBLEK3bsy5sk4vTOEk,3306
+orionis/container/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/container/providers/service_provider.py,sha256=rkrSxdNEi357aNs6MalOIy7-bNnb8E98fGhnBmE8GDs,1830
 orionis/container/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/validators/implements.py,sha256=iSoDxxTalQKhyKjvsojFlkROhBFvAjvJxRvPJlmGrSg,2843
 orionis/container/validators/is_abstract_class.py,sha256=Q-Lqyrrps6oj2XWI0KFRp-hDZf4_sgbZlEbfBXj5XT4,1169
@@ -243,7 +246,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=IhPmn8wBfMaPIOA6TEFEcnsrQ6JRJkYY7ET01P4bSBU,4960
+orionis/metadata/framework.py,sha256=3pSdy6bnr8_6wagciqStvz0g2gtRfgoH6E-JRTI5p-8,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
@@ -355,7 +358,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.325.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.327.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
@@ -456,8 +459,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.325.0.dist-info/METADATA,sha256=I_YFjyuy8QRXf_lRW03geTqwLoN1QgHe-LXTm2_qk3Q,4772
-orionis-0.325.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.325.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.325.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.325.0.dist-info/RECORD,,
+orionis-0.327.0.dist-info/METADATA,sha256=GPE066gZMY-Rwse4II2FCF2LFnDbQQX81nenlgnP3DU,4772
+orionis-0.327.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.327.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.327.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.327.0.dist-info/RECORD,,