orionis 0.321.0__py3-none-any.whl → 0.323.0__py3-none-any.whl

orionis/container/container.py

@@ -1,5 +1,6 @@
 import threading
 from typing import Any, Callable
+from orionis.container.context.manager import ScopeManager
 from orionis.container.contracts.container import IContainer
 from orionis.container.entities.binding import Binding
 from orionis.container.enums.lifetimes import Lifetime
@@ -430,7 +431,7 @@ class Container(IContainer):
         # Return True to indicate successful registration
         return True
 
-    def function(
+    def callable(
         self,
         alias: str,
         fn: Callable[..., Any],
@@ -633,4 +634,26 @@ class Container(IContainer):
             binding,
             *args,
             **kwargs
-        )
+        )
+
+    def createContext(self) -> ScopeManager:
+        """
+        Creates a new context for managing scoped services.
+
+        This method returns a context manager that can be used with a 'with' statement
+        to control the lifecycle of scoped services.
+
+        Returns
+        -------
+        ScopeManager
+            A context manager for scoped services.
+
+        Usage
+        -------
+        with container.createContext():
+            # Scoped services created here will be disposed when exiting this block
+            service = container.make(IScopedService)
+            ...
+        # Scoped services are automatically disposed here
+        """
+        return ScopeManager()

orionis/container/context/manager.py

@@ -0,0 +1,94 @@
+from orionis.container.context.scope import ScopedContext
+
+class ScopeManager:
+    """
+    A context manager to manage scoped lifetimes in the container.
+    """
+    def __init__(self):
+        """
+        Initialize a new ScopeManager with an empty instances dictionary.
+        """
+        self._instances = {}
+
+    def __getitem__(self, key):
+        """
+        Get an instance by key.
+
+        Parameters
+        ----------
+        key : hashable
+            The key of the instance to retrieve.
+
+        Returns
+        -------
+        object or None
+            The instance associated with the key or None if not found.
+        """
+        return self._instances.get(key)
+
+    def __setitem__(self, key, value):
+        """
+        Store an instance by key.
+
+        Parameters
+        ----------
+        key : hashable
+            The key to associate with the instance.
+        value : object
+            The instance to store.
+        """
+        self._instances[key] = value
+
+    def __contains__(self, key):
+        """
+        Check if a key exists in this scope.
+
+        Parameters
+        ----------
+        key : hashable
+            The key to check.
+
+        Returns
+        -------
+        bool
+            True if the key exists in the scope, False otherwise.
+        """
+        return key in self._instances
+
+    def clear(self):
+        """
+        Clear all instances from this scope.
+        """
+        self._instances.clear()
+
+    def __enter__(self):
+        """
+        Enter the scope context.
+
+        Sets this scope as the current active scope.
+
+        Returns
+        -------
+        ScopeManager
+            This scope manager instance.
+        """
+        ScopedContext.setCurrentScope(self)
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """
+        Exit the scope context.
+
+        Clears this scope and the active scope reference.
+
+        Parameters
+        ----------
+        exc_type : type or None
+            The exception type if an exception was raised, None otherwise.
+        exc_val : Exception or None
+            The exception instance if an exception was raised, None otherwise.
+        exc_tb : traceback or None
+            The exception traceback if an exception was raised, None otherwise.
+        """
+        self.clear()
+        ScopedContext.clear()

orionis/container/context/scope.py

@@ -0,0 +1,40 @@
+import contextvars
+
+class ScopedContext:
+    """
+    Holds scoped instances for the current context.
+    """
+    _active_scope = contextvars.ContextVar("orionis_scope", default=None)
+
+    @classmethod
+    def getCurrentScope(cls):
+        """
+        Get the currently active scope.
+
+        Returns
+        -------
+        object or None
+            The current active scope or None if no scope is active.
+        """
+        return cls._active_scope.get()
+
+    @classmethod
+    def setCurrentScope(cls, scope):
+        """
+        Set the current active scope.
+
+        Parameters
+        ----------
+        scope : object
+            The scope object to set as active.
+        """
+        cls._active_scope.set(scope)
+
+    @classmethod
+    def clear(cls):
+        """
+        Clear the current active scope.
+
+        Sets the active scope to None.
+        """
+        cls._active_scope.set(None)

orionis/container/contracts/container.py

@@ -131,7 +131,7 @@ class IContainer(ABC):
         pass
 
     @abstractmethod
-    def function(
+    def callable(
         self,
         alias: str,
         fn: Callable[..., Any],

orionis/container/facades/facade.py

@@ -0,0 +1,60 @@
+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

orionis/container/resolver.py

@@ -1,4 +1,5 @@
 from typing import Any, Callable
+from orionis.container.context.scope import ScopedContext
 from orionis.container.contracts.container import IContainer
 from orionis.container.entities.binding import Binding
 from orionis.container.enums.lifetimes import Lifetime
@@ -61,10 +62,7 @@ class Resolver:
         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."
-            )
+            return self.__resolveScoped(binding, *args, **kwargs)
 
     def __resolveTransient(self, binding: Binding, *args, **kwargs) -> Any:
         """
@@ -153,6 +151,58 @@ class Resolver:
                 "Cannot resolve singleton binding: neither a concrete class, instance, nor function is defined."
             )
 
+    def __resolveScoped(self, binding: Binding, *args, **kwargs) -> Any:
+        """
+        Resolves a service with scoped 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
+            The scoped instance of the requested service.
+
+        Raises
+        ------
+        OrionisContainerException
+            If no scope is active or service can't be resolved.
+        """
+        scope = ScopedContext.getCurrentScope()
+        if scope is None:
+            raise OrionisContainerException(
+                f"No active scope found while resolving scoped service '{binding.alias}'. "
+                f"Use 'with container.createContext():' to create a scope context."
+            )
+
+        if binding.alias in scope:
+            return scope[binding.alias]
+
+        # Create a new instance
+        if binding.concrete:
+            if args or kwargs:
+                instance = self.__instantiateConcreteWithArgs(binding.concrete, *args, **kwargs)
+            else:
+                instance = self.__instantiateConcreteReflective(binding.concrete)
+        elif binding.function:
+            if args or kwargs:
+                instance = self.__instantiateCallableWithArgs(binding.function, *args, **kwargs)
+            else:
+                instance = self.__instantiateCallableReflective(binding.function)
+        else:
+            raise OrionisContainerException(
+                "Cannot resolve scoped binding: neither a concrete class nor a function is defined."
+            )
+
+        scope[binding.alias] = instance
+        return instance
+
     def __instantiateConcreteWithArgs(self, concrete: Callable[..., Any], *args, **kwargs) -> Any:
         """
         Instantiates a concrete class with the provided arguments.
@@ -401,4 +451,3 @@ class Resolver:
 
             # Raise a more informative exception
             raise OrionisContainerException(error_msg) from e
-

orionis/metadata/framework.py

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

{orionis-0.321.0.dist-info → orionis-0.323.0.dist-info}/METADATA

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

{orionis-0.321.0.dist-info → orionis-0.323.0.dist-info}/RECORD

@@ -2,12 +2,6 @@ orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_application.py,sha256=dMjJ0nFcIIOBGb5zr-tHNzcgTOZ1vJ7iMdFAlqSQph0,9405
 orionis/application.py,sha256=Off5uOUj-IYvvR8DcqLUoBW_98opWa7MQrtqTr0SZGc,292
 orionis/unittesting.py,sha256=_NU3_sm3R6bUUH_Y-KSPgNVBajUGCtKo_CGgjB1YD5k,2094
-orionis/_container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_container/container.py,sha256=0AOqTNwpN_OtWbq9mBI99qfJ7LMkN71y0lP0JWKzut0,18289
-orionis/_container/container_integrity.py,sha256=vrqZrkJaP6ghbiAzr-nEul9f_lEWVa2nMUSugQXDfWk,10095
-orionis/_container/exception.py,sha256=ap1SqYEjQEEHXJJTNmL7V1jrmRjgT5_7geZ95MYkhMA,1691
-orionis/_container/lifetimes.py,sha256=2lbdiV7R2WlJf1cLD6eBxLnJud_lZvX1IhQH2Djy3Ww,375
-orionis/_container/resolve.py,sha256=5qVE--fBpbVFiTYM_jXKbjHNssm28aM4cwd49AhiLkY,2231
 orionis/_contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_contracts/application.py,sha256=ltuDA1mN5P73l89jJto_A96ePJWE02OZ_B2NOPpfeWs,1061
 orionis/_contracts/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -135,14 +129,19 @@ 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=eBVQMzfSvXcxrdm-0hq0gmXZzxf3uabIcxbGVvGZmIo,22342
-orionis/container/resolver.py,sha256=iuyTWCnCqWXQCtWvFXPdS9cR_g3Q58_wjHVn0Yg0YNM,16209
-orionis/container/contracts/container.py,sha256=ksMn6ZLnFkIxd9_hbUGz3OpHzaYTA5izcDtH959kOow,7603
+orionis/container/container.py,sha256=dIfHPCC28_Eho7kgp0AUFS1S5iaCD4ws7udCy_jQ6sE,23112
+orionis/container/resolver.py,sha256=bR26v1bAtg9FgDtfs6zP30-g75aWrSO43UJPweJ7jfo,18014
+orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/container/context/manager.py,sha256=9yODWkHBoJ2kgJZ5ONLqcEcex50vaWuMcxsvmDgnQo4,2437
+orionis/container/context/scope.py,sha256=CWFiLLTAC_IdmeFKWX-jrphdxB0_TMEVBlz6lQVMPC8,937
+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/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=8YMuZp9Mc--OfGzcyDbSke8Xi5V1kpRglHvMWftr1DQ,2075
 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
@@ -244,7 +243,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=gv-aVbvyQwRvOTPPCJTIwJffZOEd9Ak6L9jdwT46oOE,4960
+orionis/metadata/framework.py,sha256=Oj4bwfkR8QW41Dfg0E01NAG-hIkgTRZiDT9rY93ZFqM,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
@@ -356,7 +355,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.321.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.323.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
@@ -457,8 +456,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.321.0.dist-info/METADATA,sha256=kQ_DamwqrnAqkqPJQZd6mR4u-U_ERbRLwEw8FqTgTwE,4772
-orionis-0.321.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.321.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.321.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.321.0.dist-info/RECORD,,
+orionis-0.323.0.dist-info/METADATA,sha256=9ItAv8CGa3j5dBYJeOZyBivus_9cy2pl5mjtNvMCIwY,4772
+orionis-0.323.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.323.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.323.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.323.0.dist-info/RECORD,,