orionis 0.369.0__py3-none-any.whl → 0.371.0__py3-none-any.whl

orionis/console/base/command.py

@@ -0,0 +1,85 @@
+import argparse
+from orionis.console.dynamic.progress_bar import ProgressBar
+from orionis.console.output.console import Console
+
+class BaseCommand(Console, ProgressBar):
+    """
+    Base abstract class for implementing console commands in the Orionis framework.
+
+    This class provides a foundation for creating command-line interface commands by
+    combining console output capabilities and progress bar functionality. It serves
+    as an abstract base that enforces the implementation of command-specific logic
+    while providing common argument handling functionality.
+
+    The class inherits from both Console and ProgressBar, providing access to:
+    - Console output methods for displaying messages, errors, and formatted text
+    - Progress bar functionality for long-running operations
+    - Argument parsing and management capabilities
+
+    Attributes
+    ----------
+    args : dict
+        Dictionary containing the parsed command-line arguments passed to the command.
+        This is populated by calling the `setArgs` method with either an
+        `argparse.Namespace` object or a dictionary.
+
+    Methods
+    -------
+    handle()
+        Abstract method that must be implemented by subclasses to define the
+        command's execution logic.
+    setArgs(args)
+        Sets the command arguments from either an argparse.Namespace or dict.
+    """
+
+    args = {}
+
+    def handle(self):
+        """
+        Execute the command's main logic.
+
+        This abstract method defines the entry point for command execution and must
+        be overridden in all subclasses. It contains the core functionality that
+        the command should perform when invoked.
+
+        The method has access to:
+        - `self.args`: Dictionary of parsed command-line arguments
+        - Console output methods inherited from Console class
+        - Progress bar methods inherited from ProgressBar class
+
+        Raises
+        ------
+        NotImplementedError
+            Always raised when called on the base class, as this method must be
+            implemented by concrete subclasses to define command-specific behavior.
+        """
+        raise NotImplementedError("The 'handle' method must be implemented in the child class.")
+
+    def setArgs(self, args) -> None:
+        """
+        Set command arguments from parsed command-line input.
+
+        This method accepts command arguments in multiple formats and normalizes
+        them into a dictionary format stored in `self.args`. It provides
+        flexibility in how arguments are passed to the command while ensuring
+        consistent internal representation.
+
+        Parameters
+        ----------
+        args : argparse.Namespace or dict
+            The command arguments to be set. Can be either:
+            - argparse.Namespace: Result of argparse.ArgumentParser.parse_args()
+            - dict: Dictionary containing argument name-value pairs
+
+        Raises
+        ------
+        ValueError
+            If `args` is neither an argparse.Namespace nor a dict, indicating
+            an unsupported argument type was passed.
+        """
+        if isinstance(args, argparse.Namespace):
+            self.args = vars(args)
+        elif isinstance(args, dict):
+            self.args = args
+        else:
+            raise ValueError("Invalid argument type. Expected 'argparse.Namespace' or 'dict'.")

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 Orionis(Container, IApplication):
     """
     Application container that manages service providers.
 
@@ -33,10 +34,22 @@ 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, '_Orionis__initialized'):
+
+            # Initialize provider-specific attributes
+            self.__providers: List[IServiceProvider] = []
+            self.__booted: bool = False
+
+            # Mark this instance as initialized
+            self.__initialized = True
 
     def __registerProvider(
         self,

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.369.0"
+VERSION = "0.371.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

{orionis-0.369.0.dist-info → orionis-0.371.0.dist-info}/METADATA

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

{orionis-0.369.0.dist-info → orionis-0.371.0.dist-info}/RECORD

@@ -96,6 +96,8 @@ orionis/_services/commands/scheduler_service.py,sha256=71iH4ZArJ2D9dfbQPSNP_S3g4
 orionis/_services/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_services/config/config_service.py,sha256=iS5ftGd7VWCpOt9M5_rNNLHsCZaDcI-F8R2r3CCTM8g,2106
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/console/base/command.py,sha256=4VUR8mF_NfoNqULh0o0jA8bvi5MTFqUFOL1bkVpgLeA,3444
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/dump.py,sha256=CATERiQ6XuIrKQsDaWcVxzTtlAJI9qLJX44fQxEX8ws,22443
 orionis/console/dumper/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -111,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
@@ -145,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=wYt664l8v95_B3ny0i83aq07OUTsp-uwF3sqYD-PtaY,5331
 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
@@ -234,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=Zr10-f7p8QKhKwGJMscX9-euuUlN8sq2BTShjSqczX4,1688
 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=wnTEOp5_Ho2LPyVNN9sB_p_JDKUcVZQZKG08IJ3Uk8c,4960
+orionis/metadata/framework.py,sha256=ELLE9bftoocsTWd1mXjuTK3xa3mgdzsQ9BRkRihfQ5g,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
@@ -377,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.369.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.371.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
@@ -478,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.369.0.dist-info/METADATA,sha256=EVeODoCcsbW2vwJOt5wNIEkVmJC2Al9RfsVShCrPxNo,4772
-orionis-0.369.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.369.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.369.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.369.0.dist-info/RECORD,,
+orionis-0.371.0.dist-info/METADATA,sha256=R3PbjmUDx3DhHzBDS9GdFoa-PHUZ45PgXWXiPB5jHh8,4772
+orionis-0.371.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.371.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.371.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.371.0.dist-info/RECORD,,

{orionis-0.369.0.dist-info → orionis-0.371.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