orionis 0.370.0__py3-none-any.whl → 0.372.0__py3-none-any.whl

orionis/__init__.py

@@ -0,0 +1,7 @@
+from orionis.foundation.application import Application as Orionis
+from orionis.foundation.contracts.application import IApplication as IOrionis
+
+__all__ = [
+    "Orionis",
+    "IOrionis"
+]

orionis/container/container.py

@@ -20,83 +20,82 @@ from orionis.services.introspection.callables.reflection import ReflectionCallab
 
 class Container(IContainer):
 
-    # Singleton instance of the container.
-    # This is a class variable that holds the single instance of the Container class.
-    _instance = None
-
-    # Lock for thread-safe singleton instantiation.
-    # This lock ensures that only one thread can create the instance at a time,
-    # preventing
-    _lock = threading.Lock()
-
-    # Class variable to track if the container has been initialized.
-    # This is used to ensure that the initialization logic runs only once,
-    # regardless of how many times the class is instantiated.
-    _initialized = False
-
-    def __new__(
-        cls
-    ) -> 'Container':
+    # Dictionary to hold singleton instances for each class
+    # This allows proper inheritance of the singleton pattern
+    _instances = {}
+
+    # Lock for thread-safe singleton instantiation and access
+    # This lock ensures that only one thread can create or access instances at a time
+    _lock = threading.RLock()  # RLock allows reentrant locking
+
+    def __new__(cls) -> 'Container':
         """
-        Creates and returns a singleton instance of the class.
+        Creates and returns a singleton instance for each specific class.
 
-        This method implements the singleton pattern, ensuring that only one instance
-        of the class exists. If an instance does not exist, it acquires a lock to
-        ensure thread safety and creates the instance. Subsequent calls return the
-        existing instance.
+        This method implements a truly thread-safe singleton pattern with proper 
+        inheritance support, ensuring that each class in the hierarchy has its own 
+        singleton instance. Uses double-checked locking with proper memory barriers.
 
         Returns
         -------
         Container
-            The singleton instance of the class.
+            The singleton instance of the specific class.
+
+        Notes
+        -----
+        This implementation is completely thread-safe and guarantees that:
+        - Only one instance per class exists across all threads
+        - Memory visibility is properly handled
+        - No race conditions can occur
+        - Inheritance is properly supported
         """
 
-        # Check if the class has an existing instance
-        if cls._instance is None:
+        # First check without lock for performance (fast path)
+        if cls in cls._instances:
+            return cls._instances[cls]
 
-            # Acquire the lock to ensure thread safety during instance creation
-            with cls._lock:
+        # Acquire the lock for the slow path (instance creation)
+        with cls._lock:
 
-                # If the instance is still None, create a new instance
-                if cls._instance is None:
+            # Double-check if the instance was created by another thread
+            # while we were waiting for the lock
+            if cls in cls._instances:
+                return cls._instances[cls]
 
-                    # Call the superclass's __new__ method to create a new instance
-                    cls._instance = super(Container, cls).__new__(cls)
+            # Create a new instance for this specific class
+            instance = super(Container, cls).__new__(cls)
 
-        # Return the existing instance of the class
-        return cls._instance
+            # Store the instance in the class-specific dictionary
+            # This write is protected by the lock, ensuring memory visibility
+            cls._instances[cls] = instance
 
-    def __init__(
-        self
-    ) -> None:
+            return instance
+
+    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.
+        ensuring that these are only initialized once per instance. The initialization
+        is guarded by checking if the instance already has the required attributes.
 
         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.
+        - Initialization occurs only once per instance, regardless of how many times __init__ is called.
         - The container registers itself under the IContainer interface to allow for dependency injection.
         """
 
-        # Check if the class has been initialized
-        if not self.__class__._initialized:
+        # Check if the instance has already been initialized
+        if not hasattr(self, '_Container__initialized'):
 
             # Initialize the container's internal state
             self.__bindings = {}
             self.__aliasses = {}
 
-            # Set the initialized flag to True to prevent re-initialization
-            self.__class__._initialized = True
-
-            # Register the container itself as a service
-            self.instance(IContainer, self)
+            # Mark this instance as initialized
+            self.__initialized = True
 
     def transient(
         self,

orionis/container/contracts/container.py

@@ -245,4 +245,27 @@ class IContainer(ABC):
         alias : str, optional
             The alias of the service to be removed.
         """
+        pass
+
+    @abstractmethod
+    def createContext(self):
+        """
+        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
+        """
         pass

orionis/foundation/application.py

@@ -1,8 +1,9 @@
 from typing import Type, List
 from orionis.container.container import Container
 from orionis.container.contracts.service_provider import IServiceProvider
+from orionis.foundation.contracts.application import IApplication
 
-class App(Container):
+class Application(Container, IApplication):
     """
     Application container that manages service providers.
 
@@ -33,10 +34,60 @@ class App(Container):
         Initialize a new App instance.
 
         Sets up the container and initializes the provider tracking system.
+        This method ensures that initialization only happens once per instance,
+        even in a singleton context.
         """
+
+        # Call parent constructor first
         super().__init__()
-        self.__providers: List[IServiceProvider] = []
-        self.__booted: bool = False
+
+        # Check if this specific instance has already been initialized
+        if not hasattr(self, '_Application__initialized'):
+
+            # Initialize provider-specific attributes
+            self.__providers: List[IServiceProvider] = []
+            self.__booted: bool = False
+
+            # Mark this instance as initialized
+            self.__initialized = True
+
+            # Bootstrap core services
+            self.__bootFramework()
+
+    def __bootFramework(self) -> None:
+        """
+        Bootstrap the application by loading internal framework providers.
+
+        This method should be called once to ensure that core services
+        required by the framework are registered before user-defined
+        providers are loaded.
+        """
+        if not self.__booted:
+            self.__loadFrameworkProviders()
+
+    def __loadFrameworkProviders(self) -> None:
+        """
+        Load internal framework service providers.
+
+        This method should register core services required by the framework
+        before user-defined providers are loaded.
+        """
+        from orionis.foundation.providers.console_provider import ConsoleProvider
+        from orionis.foundation.providers.dumper_provider import DumperProvider
+        from orionis.foundation.providers.path_resolver_provider import PathResolverProvider
+        from orionis.foundation.providers.progress_bar_provider import ProgressBarProvider
+        from orionis.foundation.providers.workers_provider import WorkersProvider
+
+        core_providers = [
+            ConsoleProvider,
+            DumperProvider,
+            PathResolverProvider,
+            ProgressBarProvider,
+            WorkersProvider
+        ]
+
+        for provider_cls in core_providers:
+            self.__registerProvider(provider_cls)
 
     def __registerProvider(
         self,
@@ -90,32 +141,7 @@ class App(Container):
 
         self.__booted = True
 
-    def __loadFrameworkProviders(self) -> None:
-        """
-        Load internal framework service providers.
-
-        This method should register core services required by the framework
-        before user-defined providers are loaded.
-        """
-        from orionis.foundation.providers.console_provider import ConsoleProvider
-        from orionis.foundation.providers.dumper_provider import DumperProvider
-        from orionis.foundation.providers.path_resolver_provider import PathResolverProvider
-        from orionis.foundation.providers.progress_bar_provider import ProgressBarProvider
-        from orionis.foundation.providers.workers_provider import WorkersProvider
-
-        core_providers = [
-            ConsoleProvider,
-            DumperProvider,
-            PathResolverProvider,
-            ProgressBarProvider,
-            WorkersProvider
-        ]
-
-        for provider_cls in core_providers:
-            self.__registerProvider(provider_cls)
-
-
-    def load(self, providers: List[Type[IServiceProvider]]) -> None:
+    def load(self, providers: List[Type[IServiceProvider]] = []) -> None:
         """
         Load and boot a list of service providers.
 
@@ -131,9 +157,6 @@ class App(Container):
         None
         """
 
-        # Load internal framework providers first
-        self.__loadFrameworkProviders()
-
         # Register and boot each provided service provider
         for provider_cls in providers:
             self.__registerProvider(provider_cls)

orionis/foundation/contracts/application.py

@@ -0,0 +1,58 @@
+from abc import abstractmethod
+from typing import List, Type
+from orionis.container.contracts.service_provider import IServiceProvider
+from orionis.container.contracts.container import IContainer
+
+class IApplication(IContainer):
+    """
+    Abstract interface for application containers that manage service providers.
+
+    This interface extends IContainer to provide application-level functionality
+    including service provider management and application lifecycle operations.
+
+    By inheriting from IContainer, this interface provides access to all container
+    methods while adding application-specific functionality.
+    """
+
+    @property
+    @abstractmethod
+    def isBooted(self) -> bool:
+        """
+        Check if the application providers have been booted.
+
+        Returns
+        -------
+        bool
+            True if providers are booted, False otherwise
+        """
+        pass
+
+    @abstractmethod
+    def load(self, providers: List[Type[IServiceProvider]] = []) -> None:
+        """
+        Load and boot a list of service providers.
+
+        This method registers each provider and then boots all providers.
+
+        Parameters
+        ----------
+        providers : List[Type[IServiceProvider]]
+            List of service provider classes to register and boot
+
+        Returns
+        -------
+        None
+        """
+        pass
+
+    @abstractmethod
+    def getProviders(self) -> List[IServiceProvider]:
+        """
+        Get the list of registered providers.
+
+        Returns
+        -------
+        List[IServiceProvider]
+            The list of registered service providers
+        """
+        pass

orionis/foundation/providers/dumper_provider.py

@@ -1,4 +1,4 @@
-from orionis._console.dumper.dump_die import Debug
+from orionis.console.dumper.dump import Debug
 from orionis.console.dumper.contracts.dump import IDebug
 from orionis.container.providers.service_provider import ServiceProvider
 

orionis/metadata/framework.py

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

{orionis-0.370.0.dist-info → orionis-0.372.0.dist-info}/METADATA

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

{orionis-0.370.0.dist-info → orionis-0.372.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/__init__.py,sha256=dtNpLau0gNc-o1gLiwsQiI0-XAK7EGGV70OaQSsdICU,194
 orionis/unittesting.py,sha256=_ukXPOOQTaaBxmWScsCO0FdlEC0uYFIxlytBXQpl1Bk,2030
 orionis/_console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_console/command_filter.py,sha256=bn0fcWfQg13DrQBaV4NopNxdP-6up0G54Qmhg7r_BKA,1211
@@ -113,12 +113,12 @@ orionis/console/output/contracts/console.py,sha256=F2c1jC_O61o7jDiXwAeZAOEodEhuC
 orionis/console/output/enums/__init__.py,sha256=LAaAxg-DpArCjf_jqZ0_9s3p8899gntDYkSU_ppTdC8,66
 orionis/console/output/enums/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/container.py,sha256=1fGOHN_4M4YAA_6ljGHB669hY6egl_Cyb6L9EZtFK9E,23083
+orionis/container/container.py,sha256=HgUoQrAz9sM2QLfiDbz2Lm_pqhZ0TRkPtGynVs7TgVU,23176
 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/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/contracts/container.py,sha256=hOO3w2yqVhp2nPTeS1uJEYgXSTbM3xwezDCOSNMC_a0,7603
+orionis/container/contracts/container.py,sha256=QV_seo8mKrZJG2Ytr2u0RSiRaTaSPw6zUxgJ_tq6oP4,8301
 orionis/container/contracts/resolver.py,sha256=mR7lztPAQDwyspoQewaTMQPxJaoOCA88euDevaZYHGo,1712
 orionis/container/contracts/service_provider.py,sha256=hXp-l4iP7q0FhsCcQAKoYcJ_zxCzIgTdfmO4F0Bbssg,896
 orionis/container/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -147,7 +147,7 @@ orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYq
 orionis/container/validators/is_valid_alias.py,sha256=4uAYcq8xov7jZbXnpKpjNkxcZtlTNnL5RRctVPMwJes,1424
 orionis/container/validators/lifetime.py,sha256=IQ43fDNrxYHMlZH2zlYDJnlkLO_eS4U7Fs3UJgQBidI,1844
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=OiBbTI-4cGTEZppVaFxDHadvsb_jRl8aDwJEwlypVLg,4799
+orionis/foundation/application.py,sha256=XQzYpmPg6yvKct24E71jcgFsEBaKt3dktWH_bs-xZZw,5720
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=zutF-34DkW68bpiTxH9xrmIe1iJdXCF9Y6wueXS6qys,8265
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -236,18 +236,19 @@ orionis/foundation/config/testing/entities/testing.py,sha256=keU7dSuRv0rgaG-T4Vo
 orionis/foundation/config/testing/enums/__init__.py,sha256=tCHed6wBzqHx8o3kWBGm8tZYkYOKdSAx8TvgC-Eauv0,75
 orionis/foundation/config/testing/enums/test_mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
 orionis/foundation/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/foundation/contracts/application.py,sha256=vgvUnzQAQlpzkfOBDR-H4Y7mL9cPZuy5QduFayx__FQ,1693
 orionis/foundation/contracts/config.py,sha256=Rpz6U6t8OXHO9JJKSTnCimytXE-tfCB-1ithP2nG8MQ,628
 orionis/foundation/exceptions/__init__.py,sha256=XtG3MJ_MFNY_dU5mmTyz_N_4QG1jYrcv5RegBso7wuY,163
 orionis/foundation/exceptions/integrity.py,sha256=mc4pL1UMoYRHEmphnpW2oGk5URhu7DJRREyzHaV-cs8,472
 orionis/foundation/exceptions/value.py,sha256=hQhXybXEnaa59ba7JxG65jceHt3mnql9MyekF-TChpM,465
 orionis/foundation/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/providers/console_provider.py,sha256=pAIklY1QKx2HKjTp7YyJT6KbJPlEEyzWSr79RTFkEK0,700
-orionis/foundation/providers/dumper_provider.py,sha256=mLJDpNNNl4PV8oM_GKBvSxBcfXRxgiBlrA9Qg5WKi0A,689
+orionis/foundation/providers/dumper_provider.py,sha256=_CjIZoa1EkITkJqFFWQuLeVpagSnb6TuSwcpvqdM-Bc,684
 orionis/foundation/providers/path_resolver_provider.py,sha256=rXvaVc5sSqmDgRzWJoattAW0ikO_SF3H7WBddVxwmhw,717
 orionis/foundation/providers/progress_bar_provider.py,sha256=75Jr4iEgUOUGl8Di1DioeP5_HRQlR-1lVzPmS96sWjA,737
 orionis/foundation/providers/workers_provider.py,sha256=WWlji3C69_-Y0c42aZDbR_bmcE_qZEh2SaA_cNkCivI,702
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=uWb-E59Z6jG1FTYOZfjfo1edZBIuB7aSMG_xOytZZlk,4960
+orionis/metadata/framework.py,sha256=8ADjfPeSm8Z1yby-YerBK9JuHdcFjHbH4lp1fqPYgcs,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -379,7 +380,7 @@ orionis/test/output/dumper.py,sha256=3EV-G3KgEV4O0M4yl-4klPKc1etWOPZvPAcYhUQyXnI
 orionis/test/output/printer.py,sha256=WGjGW2lgu_l5wWJ6Z8qTTV7NAObhoTBcvhM1TcNvwU4,16938
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=jXZkbITBknbUwm_mD8bcTiwLDvsFkrO9qrf0ZgPwqxc,4903
-orionis-0.370.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.372.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
@@ -480,8 +481,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=hIVqGt19vbW22xPjQS
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=1O_8xjsFPnzwZOpLT6ImqjO9HY5_jIgP7DTVBsgHvQA,4335
 tests/testing/test_testing_unit.py,sha256=S3anwYcF2DBWYh_UfqKcZq2FgNpQjP0SfYVRd5sD5rI,7442
-orionis-0.370.0.dist-info/METADATA,sha256=ThIPJvF6BMpzcZ7eG6-X8ojdk7l_Ce8Meo7rddmoVlE,4772
-orionis-0.370.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.370.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.370.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.370.0.dist-info/RECORD,,
+orionis-0.372.0.dist-info/METADATA,sha256=VBCV-xWsB9MHdjLDwJTFMwA8s0RFg_X9p5c1tFfHhSM,4772
+orionis-0.372.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.372.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.372.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.372.0.dist-info/RECORD,,

{orionis-0.370.0.dist-info → orionis-0.372.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.7.1)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any