orionis 0.389.0__py3-none-any.whl → 0.390.0__py3-none-any.whl

orionis/foundation/application.py

@@ -6,18 +6,18 @@ from orionis.foundation.contracts.application import IApplication
 
 class Application(Container, IApplication):
     """
-    Application container that manages service providers.
+    Application container that manages service providers and application lifecycle.
 
-    This class extends the base Container functionality by adding
-    a service provider registration and boot system.
+    This class extends Container to provide application-level functionality including
+    service provider management, kernel loading, and application bootstrapping.
+    It implements a fluent interface pattern allowing method chaining.
 
     Attributes
     ----------
-    __providers : List[IServiceProvider]
-        List of registered service providers
-    __booted : bool
-        Flag indicating whether providers have been booted
+    isBooted : bool
+        Read-only property indicating if the application has been booted
     """
+
     @property
     def isBooted(
         self
@@ -32,82 +32,45 @@ class Application(Container, IApplication):
         """
         return self.__booted
 
-    @property
-    def path(
-        self,
-        name: str = None
-    ) -> Paths:
-
-        if name is None:
-            return self.__paths
-
-        if hasattr(self.__paths, name):
-            return getattr(self.__paths, name)
-
-        raise AttributeError(f"Path '{name}' not found in application paths")
-
     def __init__(
         self
     ) -> None:
         """
-        Initialize a new App instance.
+        Initialize the Application container.
 
-        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.
+        Sets up initial state including empty providers list and booted flag.
+        Uses singleton pattern to prevent multiple initializations.
         """
-
-        # Call parent constructor first
+        # Initialize base container with application paths
         super().__init__()
 
-        # Check if this specific instance has already been initialized
+        # Singleton pattern - prevent multiple initializations
         if not hasattr(self, '_Application__initialized'):
-
-            # Initialize provider-specific attributes
             self.__providers: List[IServiceProvider] = []
             self.__booted: bool = False
-
-            # List of paths for the application
-            self.__paths: Paths = None
-
-            # 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()
-            self.__loadFrameworksKernel()
-
     def __loadFrameworkProviders(
         self
     ) -> None:
         """
-        Load internal framework service providers.
+        Load core framework service providers.
 
-        This method should register core services required by the framework
-        before user-defined providers are loaded.
+        Registers essential providers required for framework operation:
+        - ConsoleProvider: Console output management
+        - DumperProvider: Data dumping utilities
+        - PathResolverProvider: Path resolution services
+        - ProgressBarProvider: Progress bar functionality
+        - WorkersProvider: Worker management
         """
-
-        # Import core provider classes
+        # Import core framework providers
         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
 
-        # List of core providers to register
+        # Core framework providers
         core_providers = [
             ConsoleProvider,
             DumperProvider,
@@ -116,61 +79,42 @@ class Application(Container, IApplication):
             WorkersProvider
         ]
 
-        # Register each core provider with the application
+        # Register each core provider
         for provider_cls in core_providers:
-            self.__registerProvider(provider_cls)
+            self.addProvider(provider_cls)
 
     def __loadFrameworksKernel(
         self
     ) -> None:
         """
-        Load the core framework kernel.
+        Load and register core framework kernels.
 
-        This method is responsible for loading the core kernel of the framework,
-        which is essential for the application to function correctly.
+        Instantiates and registers kernel components:
+        - TestKernel: Testing framework kernel
         """
-
-        # Import Kernel classes
+        # Import core framework kernels
         from orionis.test.kernel import TestKernel, ITestKernel
 
-        # List of core kernels to register
+        # Core framework kernels
         core_kernels = {
             ITestKernel: TestKernel
         }
 
-        # Register each core kernel with the application
+        # Register each kernel instance
         for kernel_name, kernel_cls in core_kernels.items():
             self.instance(kernel_name, kernel_cls(self))
 
-    def __registerProvider(
-        self,
-        provider_cls: Type[IServiceProvider]
-    ) -> IServiceProvider:
+    def __registerProviders(
+        self
+    ) -> None:
         """
-        Register a service provider with the application.
-
-        Parameters
-        ----------
-        provider_cls : Type[IServiceProvider]
-            The service provider class to register
+        Register all added service providers.
 
-        Returns
-        -------
-        IServiceProvider
-            The instantiated provider
-
-        Raises
-        ------
-        TypeError
-            If the provided class doesn't implement IServiceProvider
+        Calls the register method on each provider to bind services
+        into the container.
         """
-        if not issubclass(provider_cls, IServiceProvider):
-            raise TypeError(f"Provider must implement IServiceProvider interface: {provider_cls.__name__}")
-
-        provider = provider_cls(self)
-        provider.register()
-        self.__providers.append(provider)
-        return provider
+        for provider in self.__providers:
+            provider.register()
 
     def __bootProviders(
         self
@@ -178,99 +122,91 @@ class Application(Container, IApplication):
         """
         Boot all registered service providers.
 
-        This method is idempotent - calling it multiple times will only
-        boot the providers once.
-
-        Raises
-        ------
-        TypeError
-            If any registered provider is not an instance of IServiceProvider
+        Calls the boot method on each provider to initialize services
+        after all providers have been registered.
         """
-        if self.__booted:
-            return
-
         for provider in self.__providers:
-            if not isinstance(provider, IServiceProvider):
-                raise TypeError(f"Expected IServiceProvider, got {type(provider).__name__}")
             provider.boot()
 
-        self.__booted = True
-
-    def load(
+    def withProviders(
         self,
         providers: List[Type[IServiceProvider]] = []
-    ) -> None:
+    ) -> 'Application':
         """
-        Load and boot a list of service providers.
-
-        This method registers each provider and then boots all providers.
+        Add multiple service providers to the application.
 
         Parameters
         ----------
-        providers : List[Type[IServiceProvider]]
-            List of service provider classes to register and boot
+        providers : List[Type[IServiceProvider]], optional
+            List of provider classes to add to the application
 
         Returns
         -------
-        None
-        """
+        Application
+            The application instance for method chaining
 
-        # Register and boot each provided service provider
+        Examples
+        --------
+        >>> app.withProviders([CustomProvider, AnotherProvider])
+        """
+        # Add each provider class
         for provider_cls in providers:
-            self.__registerProvider(provider_cls)
+            self.addProvider(provider_cls)
+        return self
 
-        # Boot all registered providers
-        self.__bootProviders()
-
-    def paths(
+    def addProvider(
         self,
-        paths: dict|Paths = None,
-        **kwargs
-    ) -> Paths:
+        provider: Type[IServiceProvider]
+    ) -> 'Application':
         """
-        Configure or retrieve the application paths.
-
-        This method configures the application's path settings using
-        the provided parameters or returns the current paths if no
-        parameters are provided.
+        Add a single service provider to the application.
 
         Parameters
         ----------
-        paths : dict or Paths, optional
-            Dictionary of paths or a Paths instance to use as the
-            application's path configuration
-        **kwargs
-            Key-value pairs to create a Paths instance if a dict
-            or Paths object is not provided
+        provider : Type[IServiceProvider]
+            The provider class to add to the application
 
         Returns
         -------
-        Paths
-            The current application Paths instance
+        Application
+            The application instance for method chaining
 
         Raises
         ------
-        ValueError
-            If the provided parameters cannot be used to create a valid Paths instance
+        TypeError
+            If provider is not a subclass of IServiceProvider
+        """
+        # Validate provider type
+        if not isinstance(provider, type) or not issubclass(provider, IServiceProvider):
+            raise TypeError(f"Expected IServiceProvider class, got {type(provider).__name__}")
+
+        # Instantiate and add provider
+        self.__providers.append(provider(self))
+        return self
+
+    def create(
+        self
+    ) -> 'Application':
+        """
+        Bootstrap the application by loading providers and kernels.
+
+        Returns
+        -------
+        Application
+            The application instance for method chaining
         """
-        # Return existing paths if no arguments provided
-        if paths is None and not kwargs:
-            if self.__paths is None:
-                self.__paths = Paths()
-            return self.__paths
-
-        # Configure paths based on input type
-        try:
-            if isinstance(paths, Paths):
-                self.__paths = paths
-            elif isinstance(paths, dict):
-                self.__paths = Paths(**paths)
-            elif kwargs:
-                self.__paths = Paths(**kwargs)
-            else:
-                raise ValueError("Invalid paths configuration: must provide a Paths object, dictionary, or keyword arguments")
-        except Exception as e:
-            raise ValueError(f"Failed to configure application paths: {str(e)}")
-
-        # Return the configured paths
-        return self.__paths
+        # Check if already booted
+        if not self.__booted:
+
+            # Load core framework components
+            self.__loadFrameworkProviders()
+            self.__loadFrameworksKernel()
+
+            # Register and boot all providers
+            self.__registerProviders()
+            self.__bootProviders()
+
+            # Mark as booted
+            self.__booted = True
+
+        return self

orionis/foundation/contracts/application.py

@@ -28,19 +28,47 @@ class IApplication(IContainer):
         pass
 
     @abstractmethod
-    def load(self, providers: List[Type[IServiceProvider]] = []) -> None:
+    def withProviders(self, providers: List[Type[IServiceProvider]] = []) -> 'IApplication':
         """
-        Load and boot a list of service providers.
-
-        This method registers each provider and then boots all providers.
+        Add multiple service providers to the application.
+        
+        Parameters
+        ----------
+        providers : List[Type[IServiceProvider]], optional
+            List of provider classes to add to the application
+        
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
 
+    @abstractmethod
+    def addProvider(self, provider: Type[IServiceProvider]) -> 'IApplication':
+        """
+        Add a single service provider to the application.
+        
         Parameters
         ----------
-        providers : List[Type[IServiceProvider]]
-            List of service provider classes to register and boot
+        provider : Type[IServiceProvider]
+            The provider class to add to the application
+        
+        Returns
+        -------
+        IApplication
+            The application instance for method chaining
+        """
+        pass
 
+    @abstractmethod
+    def create(self) -> 'IApplication':
+        """
+        Bootstrap the application by loading providers and kernels.
+        
         Returns
         -------
-        None
+        IApplication
+            The application instance for method chaining
         """
         pass

orionis/metadata/framework.py

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

{orionis-0.389.0.dist-info → orionis-0.390.0.dist-info}/METADATA

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

{orionis-0.389.0.dist-info → orionis-0.390.0.dist-info}/RECORD

@@ -146,7 +146,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=W10L3pRPq9LdQZivp5yMEUqfP5lHoLbwOdUhoxufST0,8598
+orionis/foundation/application.py,sha256=HicY1ZiFLLPVSD21Pd3PofrvO_3tmRldQGuaMvlAZuA,6620
 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
@@ -235,7 +235,7 @@ 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=pfAngQvnnVjVZH2GhH2Bt8-540EOxWybVQa7dyeHGtg,1404
+orionis/foundation/contracts/application.py,sha256=AR1SlIu6aUChLNx2PbZk1ZQgX9vgDrS51wMPaiF05O4,2217
 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
@@ -247,7 +247,7 @@ orionis/foundation/providers/path_resolver_provider.py,sha256=rXvaVc5sSqmDgRzWJo
 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=Nv5FuKmTL1DZWOQ2wHYrB0EpKqEnMbeopiaiHAMu454,4960
+orionis/metadata/framework.py,sha256=4IaQW9cQElsqCRrzC5h3HRoeIleA_458JLSI8_OwCzg,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
@@ -384,7 +384,7 @@ orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
 orionis/test/records/logs.py,sha256=EOQcloMVdhlNl2lU9igQz8H4b-OtKtiwh2pgr_QZWOI,13186
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=zd7xDvVfmQ2HxZamDTzL2-z2PpyL99EaolbbM7wTah4,5014
-orionis-0.389.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.390.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=8G7kp74PZZ0Tdnw8WkheZ7lvZVFpdx_9ShOZBN9GEF0,25582
@@ -485,8 +485,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=nTNrvJkMSPx_aopEQ9
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=fnH7hjumNSErAFGITJgq2LHxSzvPF2tdtmHL9kyAv-Y,4409
 tests/testing/test_testing_unit.py,sha256=d3CRGo6608fMzYcZKIKapjx_af2aigqWiKSiuK9euIY,7600
-orionis-0.389.0.dist-info/METADATA,sha256=oYUguE2hLj97apwuPA7C8ky9x-OSA3lrXxsxdzsMj9Q,4772
-orionis-0.389.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.389.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.389.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.389.0.dist-info/RECORD,,
+orionis-0.390.0.dist-info/METADATA,sha256=1ShLkVPP1VxI_7rCb6tiPjJlE1LqzB17JANoSQOV6FY,4772
+orionis-0.390.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.390.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.390.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.390.0.dist-info/RECORD,,