orionis 0.103.0__tar.gz → 0.110.0__tar.gz

{orionis-0.103.0/orionis.egg-info → orionis-0.110.0}/PKG-INFO

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

orionis-0.110.0/orionis/contracts/foundation/i_bootstraper.py

@@ -0,0 +1,41 @@
+from abc import ABC, abstractmethod
+from typing import Any
+
+class IBootstrapper(ABC):
+
+    @abstractmethod
+    def _autoload(self) -> None:
+        """
+        Loads environment variables from the `.env` file or creates the file if it does not exist.
+
+        This method checks if the `.env` file exists in the current working directory.
+        If the file does not exist, it creates an empty `.env` file. If the file exists,
+        it loads the environment variables into the `_environment_vars` dictionary.
+
+        Raises
+        ------
+        PermissionError
+            If the `.env` file cannot be created or read due to insufficient permissions.
+        """
+        pass
+
+    def get(self, *args, **kwargs) -> Any:
+        """
+        Retrieves the value of an environment variable.
+
+        Parameters
+        ----------
+        key : str
+            The name of the environment variable.
+
+        Returns
+        -------
+        str
+            The value of the environment variable.
+
+        Raises
+        ------
+        KeyError
+            If the environment variable does not exist.
+        """
+        pass

orionis-0.110.0/orionis/contracts/foundation/providers/i_service_providers_bootstrapper.py

@@ -0,0 +1,59 @@
+from abc import ABC, abstractmethod
+from orionis.luminate.providers.service_provider import ServiceProvider
+
+class IServiceProvidersBootstrapper(ABC):
+
+    @abstractmethod
+    def _autoload(self) -> None:
+        """
+        Scans the provider directories and loads provider classes.
+
+        This method searches for Python files in the specified directories, imports them,
+        and registers any class that inherits from `ServiceProvider`.
+
+        Raises
+        ------
+        BootstrapRuntimeError
+            If there is an error loading a module.
+        """
+        pass
+
+    @abstractmethod
+    def _register(self, concrete: ServiceProvider) -> None:
+        """
+        Validates and registers a service provider class.
+
+        This method ensures that the provided class is valid (inherits from `ServiceProvider`,
+        has a `register` and `boot` method) and registers it in the
+        `_service_providers` dictionary.
+
+        Parameters
+        ----------
+        concrete : ServiceProvider
+            The service provider class to register
+        """
+        pass
+
+    @abstractmethod
+    def getBeforeServiceProviders(self) -> list:
+        """
+        Retrieve the registered service providers.
+
+        Returns
+        -------
+        list
+            A list of registered service providers
+        """
+        pass
+
+    @abstractmethod
+    def getAfterServiceProviders(self) -> list:
+        """
+        Retrieve the registered service providers.
+
+        Returns
+        -------
+        list
+            A list of registered service providers
+        """
+        pass

{orionis-0.103.0 → orionis-0.110.0}/orionis/framework.py

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

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/app.py

@@ -1,15 +1,13 @@
 from typing import Any, Callable
+from orionis.contracts.foundation.i_bootstraper import IBootstrapper
+from orionis.luminate.console.output.console import Console
 from orionis.luminate.container.container import Container
 from orionis.luminate.foundation.config.config_bootstrapper import ConfigBootstrapper
 from orionis.luminate.foundation.console.command_bootstrapper import CommandsBootstrapper
 from orionis.luminate.foundation.environment.environment_bootstrapper import EnvironmentBootstrapper
+from orionis.luminate.foundation.providers.service_providers_bootstrapper import ServiceProvidersBootstrapper
 from orionis.luminate.patterns.singleton import SingletonMeta
-from orionis.luminate.providers.commands.reactor_commands_service_provider import ReactorCommandsServiceProvider
-from orionis.luminate.providers.commands.scheduler_provider import ScheduleServiceProvider
-from orionis.luminate.providers.environment.environment__service_provider import EnvironmentServiceProvider
-from orionis.luminate.providers.config.config_service_provider import ConfigServiceProvider
-from orionis.luminate.providers.files.paths_provider import PathResolverProvider
-from orionis.luminate.providers.log.log_service_provider import LogServiceProvider
+from orionis.luminate.providers.service_provider import ServiceProvider
 
 class Application(metaclass=SingletonMeta):
     """
@@ -50,6 +48,8 @@ class Application(metaclass=SingletonMeta):
             The dependency injection container for the application.
         """
         # Class attributes
+        self._before_boot_service_providers: list = []
+        self._after_boot_service_providers: list = []
         self._config: dict = {}
         self._commands: dict = {}
         self._environment_vars: dict = {}
@@ -58,7 +58,10 @@ class Application(metaclass=SingletonMeta):
         # Initialize the application container
         self.container = container
         self.container.instance(container)
-        self.boot()
+        try:
+            self._boot()
+        except Exception as e:
+            Console.exception(e)
 
     def isBooted(self) -> bool:
         """
@@ -186,101 +189,118 @@ class Application(metaclass=SingletonMeta):
         """
         return self.container.forgetScopedInstances()
 
-    def boot(self):
+    def _boot(self):
         """
-        Bootstraps the application.
-
-        This method is responsible for loading the environment, configuration, and core providers.
-        It ensures the application is ready to handle requests or commands.
+        Bootstraps the application by loading environment configuration and core providers.
+        Notes
+        -----
+        The bootstrapping process involves several steps:
+        1. Loading essential services.
+        2. Executing pre-bootstrap provider hooks.
+        3. Initializing core components.
+        4. Executing post-bootstrap provider hooks.
+        5. Loading command-line interface commands.
+        After these steps, the application is marked as booted.
         """
-        # Load environment server
+        self._bootServices()
         self._beforeBootstrapProviders()
-
-        # Dynamically load application configuration
         self._bootstraping()
-
-        # Load core providers
         self._afterBootstrapProviders()
-
-        # Set the booted flag to True
+        self._loadCommands()
         self._booted = True
 
-    def _beforeBootstrapProviders(self):
+    def _bootServices(self):
         """
-        Registers and boots essential providers required before bootstrapping.
+        Bootstraps the application services.
+
+        This method is responsible for loading the application's services. It reads all the
+        ServiceProviders from the Core and those defined by the developer. Then, it stores
+        in class dictionaries the services that need to be loaded before and after the Bootstrap.
+
+        Parameters
+        ----------
+        None
 
-        This method ensures that environment variables are loaded and available
-        for use during the bootstrapping process.
+        Returns
+        -------
+        None
         """
-        # Load the path provider, which is responsible for resolving file paths.
-        # Developers can interact with it through the facade "orionis.luminate.facades.files.paths.paths_facade.Paths".
-        _path_provider = PathResolverProvider(app=self.container)
-        _path_provider.register()
-        _path_provider.boot()
+        services_bootstrapper_key = self.singleton(ServiceProvidersBootstrapper)
+        services_bootstrapper: ServiceProvidersBootstrapper = self.make(services_bootstrapper_key)
+        self._before_boot_service_providers = services_bootstrapper.getBeforeServiceProviders()
+        self._after_boot_service_providers = services_bootstrapper.getAfterServiceProviders()
 
-        # Load the environment provider, which is responsible for returning values from the .env file.
-        # This provider is essential as it must be loaded first to resolve environment variables.
-        # Developers can interact with it through the facade "orionis.luminate.facades.environment.environment_facade.Env".
-        _environment_provider = EnvironmentServiceProvider(app=self.container)
-        _environment_provider.register()
-        _environment_provider.boot()
+    def _beforeBootstrapProviders(self):
+        """
+        Loads and registers essential services before bootstrapping.
+
+        This method is responsible for loading and registering the services that are
+        required before the main bootstrapping process. It iterates through the list
+        of service providers that need to be initialized early, registers them, and
+        then boots them to make sure they are ready for use.
+        """
+        for service in self._before_boot_service_providers:
+            _environment_provider : ServiceProvider = service(app=self.container)
+            _environment_provider.register()
+            _environment_provider.boot()
 
     def _bootstraping(self):
         """
-        Loads user-defined configuration, commands, and environment variables.
+        Loads configuration, commands, environment variables, and other bootstrappers.
 
-        This method initializes the configuration, commands, and environment variables
-        required for the application to function.
-        """
-        # This initializer loads the user-defined configuration from the "config" folder.
-        # It extracts configuration values and stores them as class properties for future use.
-        config_bootstrapper_key = self.singleton(ConfigBootstrapper)
-        config_bootstrapper: ConfigBootstrapper = self.make(config_bootstrapper_key)
-        self._config = config_bootstrapper.get()
-
-        # This initializer dynamically searches for all user-defined commands in the "commands" folder,
-        # both from the framework core and developer-defined commands.
-        # It stores them in a dictionary and registers them in the container.
-        commands_bootstrapper_key = self.singleton(CommandsBootstrapper)
-        commands_bootstrapper: CommandsBootstrapper = self.make(commands_bootstrapper_key)
-        self._commands = commands_bootstrapper.get()
-        for command in self._commands.keys():
-            _key_instance_container = self.bind(self._commands[command].get('concrete'))
-            self.alias(alias=command, concrete=_key_instance_container)
+        This method initializes and updates the class dictionaries with the results
+        from various bootstrappers. It ensures that the application has the necessary
+        configuration, commands, and environment variables loaded before proceeding
+        with the rest of the bootstrapping process.
+        """
+        singletons_bootstrappers = [
+            (self._config, ConfigBootstrapper),
+            (self._commands, CommandsBootstrapper),
+            (self._environment_vars, EnvironmentBootstrapper)
+        ]
+        for bootstrapper in singletons_bootstrappers:
+            property_cls, bootstrapper_class = bootstrapper
+            bootstrapper_key = self.singleton(bootstrapper_class)
+            bootstrapper_instance : IBootstrapper = self.make(bootstrapper_key)
+            property_cls.update(bootstrapper_instance.get())
+
+    def _loadCommands(self):
+        """
+        Loads CLI commands, including both core system commands and those defined by the developer.
+
+        This method iterates over the commands stored in the `_commands` attribute, binds each command 
+        to its corresponding concrete implementation, and registers the command alias.
 
-        # Load environment variables and store them as class properties.
-        # This is useful for executing future tasks conditioned on environment values.
-        environment_bootstrapper_key = self.singleton(EnvironmentBootstrapper)
-        environment_bootstrapper: EnvironmentBootstrapper = self.make(environment_bootstrapper_key)
-        self._environment_vars = environment_bootstrapper.get()
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        None
+        """
+        for command in self._commands.keys():
+            data_command:dict = self._commands[command]
+            id_container_concrete = self.bind(data_command.get('concrete'))
+            self.alias(alias=command, concrete=id_container_concrete)
 
     def _afterBootstrapProviders(self):
         """
-        Registers and boots additional providers after bootstrapping.
+        Loads services into the container that depend on the Bootstrap process being completed.
+
+        This method iterates over the list of service providers that need to be loaded after the
+        Bootstrap process. For each service provider, it creates an instance, registers it, and
+        then boots it.
 
-        This method ensures that configuration and logging providers are loaded
-        and available for use in the application.
-        """
-        # Load the configuration provider, which is responsible for returning configuration values.
-        # Developers can interact with it through the facade "orionis.luminate.facades.config.config_facade.Config".
-        _environment_provider = ConfigServiceProvider(app=self.container)
-        _environment_provider.register()
-        _environment_provider.boot()
-
-        # Load the log provider based on the application configuration defined by the developer.
-        # Developers can interact with it through the facade "orionis.luminate.facades.log.log_facade.Log".
-        _log_provider = LogServiceProvider(app=self.container)
-        _log_provider.register()
-        _log_provider.boot()
-
-        # Load the scheduler provider, which is responsible for managing scheduled tasks.
-        # Developers can interact with it through the facade "orionis.luminate.facades.scheduler.scheduler_facade.Schedule".
-        _schedule_provider = ScheduleServiceProvider(app=self.container)
-        _schedule_provider.register()
-        _schedule_provider.boot()
-
-        # Load the commands provider, which is responsible for executing and managing CLI commands.
-        # Developers can interact with it through the facade "orionis.luminate.facades.commands.commands_facade.Commands".
-        _commands_provider = ReactorCommandsServiceProvider(app=self.container)
-        _commands_provider.register()
-        _commands_provider.boot()
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        None
+        """
+        for service in self._after_boot_service_providers:
+            _environment_provider : ServiceProvider = service(app=self.container)
+            _environment_provider.register()
+            _environment_provider.boot()

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/container/container.py

@@ -75,7 +75,7 @@ class Container(IContainer):
             If the service is already registered.
         """
         if self.has(obj):
-            raise OrionisContainerValueError("The service is already registered in the container.")
+            raise OrionisContainerValueError(f"The service ({str(obj)}) is already registered in the container.")
 
     def _ensureIsCallable(self, concrete: Callable[..., Any]) -> None:
         """

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/foundation/config/config_bootstrapper.py

@@ -2,7 +2,7 @@ import importlib
 import pathlib
 from dataclasses import asdict
 from typing import Any, Dict
-from orionis.contracts.bootstrap.i_config_bootstrapper import IConfigBootstrapper
+from orionis.contracts.foundation.config.i_config_bootstrapper import IConfigBootstrapper
 from orionis.contracts.config.i_config import IConfig
 from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
 

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/foundation/console/command_bootstrapper.py

@@ -2,7 +2,7 @@ import pathlib
 import importlib
 import inspect
 from typing import Any, Callable, Dict, List
-from orionis.contracts.bootstrap.i_command_bootstrapper import ICommandsBootstrapper
+from orionis.contracts.foundation.console.i_command_bootstrapper import ICommandsBootstrapper
 from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
 from orionis.luminate.console.base.command import BaseCommand
 

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/foundation/environment/environment_bootstrapper.py

@@ -1,5 +1,5 @@
 from typing import Dict
-from orionis.contracts.bootstrap.i_environment_bootstrapper import IEnvironmentBootstrapper
+from orionis.contracts.foundation.environment.i_environment_bootstrapper import IEnvironmentBootstrapper
 from orionis.luminate.facades.app import app
 from orionis.luminate.services.environment.environment_service import EnvironmentService
 

orionis-0.110.0/orionis/luminate/foundation/providers/service_providers_bootstrapper.py

@@ -0,0 +1,98 @@
+import importlib
+import inspect
+import pathlib
+from orionis.contracts.foundation.providers.i_service_providers_bootstrapper import IServiceProvidersBootstrapper
+from orionis.luminate.container.container import Container
+from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
+from orionis.luminate.providers.service_provider import ServiceProvider
+
+class ServiceProvidersBootstrapper(IServiceProvidersBootstrapper):
+
+    def __init__(self, container : Container) -> None:
+        self._container = container
+        self._before_providers = []
+        self._after_providers = []
+        self._autoload()
+
+    def _autoload(self) -> None:
+        """
+        Scans the provider directories and loads provider classes.
+
+        This method searches for Python files in the specified directories, imports them,
+        and registers any class that inherits from `ServiceProvider`.
+
+        Raises
+        ------
+        BootstrapRuntimeError
+            If there is an error loading a module.
+        """
+
+        base_path = pathlib.Path.cwd()
+
+        command_dirs = [
+            pathlib.Path(__file__).resolve().parent.parent.parent / "providers"
+        ]
+
+        for cmd_dir in command_dirs:
+            if not cmd_dir.is_dir():
+                continue
+
+            for file_path in cmd_dir.rglob("*.py"):
+                if file_path.name == "__init__.py":
+                    continue
+
+                module_path = ".".join(file_path.relative_to(base_path).with_suffix("").parts)
+
+                # Remove 'site-packages.' prefix if present
+                if 'site-packages.' in module_path:
+                    module_path = module_path.split('site-packages.')[1]
+
+                try:
+                    module = importlib.import_module(module_path.strip())
+
+                    # Find and register command classes
+                    for name, concrete in inspect.getmembers(module, inspect.isclass):
+                        if issubclass(concrete, ServiceProvider) and concrete is not ServiceProvider:
+                            self._register(concrete)
+                except Exception as e:
+                    raise BootstrapRuntimeError(f"Error loading {module_path}") from e
+
+    def _register(self, concrete: ServiceProvider) -> None:
+        """
+        Validates and registers a service provider class.
+
+        This method ensures that the provided class is valid (inherits from `ServiceProvider`,
+        has a `register` and `boot` method) and registers it in the
+        `_service_providers` dictionary.
+
+        Parameters
+        ----------
+        concrete : ServiceProvider
+            The service provider class to register
+        """
+        if concrete.beferoBootstrapping:
+            self._before_providers.append(concrete)
+        else:
+            self._after_providers.append(concrete)
+
+    def getBeforeServiceProviders(self) -> list:
+        """
+        Retrieve the registered service providers.
+
+        Returns
+        -------
+        list
+            A list of registered service providers
+        """
+        return self._before_providers
+
+    def getAfterServiceProviders(self) -> list:
+        """
+        Retrieve the registered service providers.
+
+        Returns
+        -------
+        list
+            A list of registered service providers
+        """
+        return self._after_providers

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/providers/environment/environment__service_provider.py

@@ -4,15 +4,12 @@ from orionis.luminate.services.files.path_resolver_service import PathResolverSe
 
 class EnvironmentServiceProvider(ServiceProvider):
 
+    beferoBootstrapping = True
+
     def register(self) -> None:
         """
         Registers services or bindings into the given container.
         """
-        self.beferoBootstrapping = True
-
-        if not self.app.bound(PathResolverService):
-            self.app.singleton(PathResolverService)
-
         self._container_id = self.app.singleton(EnvironmentService)
 
     def boot(self) -> None:

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/providers/files/paths_provider.py

@@ -3,11 +3,12 @@ from orionis.luminate.services.files.path_resolver_service import PathResolverSe
 
 class PathResolverProvider(ServiceProvider):
 
+    beferoBootstrapping = True
+
     def register(self) -> None:
         """
         Registers services or bindings into the given container.
         """
-        self.beferoBootstrapping = True
         self._container_id = self.app.singleton(PathResolverService)
 
     def boot(self) -> None:

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/providers/service_provider.py

@@ -11,6 +11,10 @@ class ServiceProvider(IServiceProvider):
         The container instance to be used by the service provider.
     """
 
+    # Indicates whether the service provider is a bootstrapper.
+    beferoBootstrapping = False
+
+
     def __init__(self, app : Container) -> None:
         """
         Initialize the service provider with the given container.
@@ -21,7 +25,6 @@ class ServiceProvider(IServiceProvider):
             The container instance to be used by the service provider.
         """
         self.app = app
-        self.beferoBootstrapping = False
 
     def register(self) -> None:
         """

{orionis-0.103.0 → orionis-0.110.0}/orionis/luminate/services/log/log_service.py

@@ -1,9 +1,9 @@
 import logging
 import os
+from pathlib import Path
 import re
 from datetime import datetime
 from logging.handlers import RotatingFileHandler, TimedRotatingFileHandler
-from pathlib import Path
 from orionis.contracts.services.log.i_log_service import ILogguerService
 from orionis.luminate.services.config.config_service import ConfigService
 
@@ -69,11 +69,16 @@ class LogguerService(ILogguerService):
         """
         try:
 
+            base = Path(self.config_service.get("logging.base_path", os.getcwd()))
+            default_path = base / "storage" / "logs"
+            default_path.mkdir(parents=True, exist_ok=True)
+            default_path = default_path / "orionis.log"
+
             handlers = []
 
             channel : str = self.config_service.get("logging.default")
             config : dict = self.config_service.get(f"logging.channels.{channel}", {})
-            path : str = config.get("path", 'logs/orionis.log')
+            path : str = config.get("path", default_path)
             app_timezone : str = self.config_service.get("app.timezone", "UTC")
 
             if channel == "stack":

{orionis-0.103.0 → orionis-0.110.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.103.0 → orionis-0.110.0}/orionis.egg-info/SOURCES.txt

@@ -12,9 +12,6 @@ orionis.egg-info/entry_points.txt
 orionis.egg-info/requires.txt
 orionis.egg-info/top_level.txt
 orionis/contracts/__init__.py
-orionis/contracts/bootstrap/i_command_bootstrapper.py
-orionis/contracts/bootstrap/i_config_bootstrapper.py
-orionis/contracts/bootstrap/i_environment_bootstrapper.py
 orionis/contracts/config/__init__.py
 orionis/contracts/config/i_config.py
 orionis/contracts/console/__init__.py
@@ -44,6 +41,16 @@ orionis/contracts/facades/log/__init__.py
 orionis/contracts/facades/log/i_log_facade.py
 orionis/contracts/facades/tests/__init__.py
 orionis/contracts/facades/tests/i_tests_facade.py
+orionis/contracts/foundation/__init__.py
+orionis/contracts/foundation/i_bootstraper.py
+orionis/contracts/foundation/config/__init__.py
+orionis/contracts/foundation/config/i_config_bootstrapper.py
+orionis/contracts/foundation/console/__init__.py
+orionis/contracts/foundation/console/i_command_bootstrapper.py
+orionis/contracts/foundation/environment/__init__.py
+orionis/contracts/foundation/environment/i_environment_bootstrapper.py
+orionis/contracts/foundation/providers/__init__.py
+orionis/contracts/foundation/providers/i_service_providers_bootstrapper.py
 orionis/contracts/installer/__init__.py
 orionis/contracts/installer/i_installer_manager.py
 orionis/contracts/installer/i_installer_output.py

orionis-0.103.0/orionis/luminate/foundation/providers/service_providers_bootstrapper.py

@@ -1,10 +0,0 @@
-from orionis.luminate.container.container import Container
-
-class ServiceProvidersBootstrapper:
-
-    def __init__(self, container : Container) -> None:
-        self._container = container
-        self._autoload()
-
-    def _autoload(self) -> None:
-        pass