orionis 0.196.0__tar.gz → 0.198.0__tar.gz

{orionis-0.196.0/orionis.egg-info → orionis-0.198.0}/PKG-INFO

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

{orionis-0.196.0 → orionis-0.198.0}/orionis/framework.py

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

{orionis-0.196.0 → orionis-0.198.0}/orionis/installer/manager.py

@@ -1,6 +1,7 @@
 import subprocess
 import sys
 from orionis.installer.contracts.manager import IInstallerManager
+from orionis.installer.contracts.output import IInstallerOutput
 from orionis.installer.output import InstallerOutput
 from orionis.installer.setup import InstallerSetup
 
@@ -13,20 +14,15 @@ class InstallerManager(IInstallerManager):
 
     Attributes
     ----------
-    output : InstallerOutput
-        Instance of Output to manage command-line display messages.
+    _output : InstallerOutput
+        Instance of InstallerOutput to manage command-line display messages.
     """
 
     def __init__(self):
         """
         Initialize the Management class with an output handler.
-
-        Parameters
-        ----------
-        output : Output
-            An instance of Output to handle command-line messages.
         """
-        self._output = InstallerOutput()
+        self._output : IInstallerOutput = InstallerOutput()
 
     def handleVersion(self) -> str:
         """
@@ -45,7 +41,7 @@ class InstallerManager(IInstallerManager):
 
         Raises
         ------
-        Exception
+        RuntimeError
             If an error occurs during the upgrade process.
         """
         try:
@@ -55,7 +51,6 @@ class InstallerManager(IInstallerManager):
         except Exception as e:
             raise RuntimeError(f"Upgrade failed: {e}")
 
-
     def handleNewApp(self, name_app: str = "example-app") -> None:
         """
         Create a new application with the specified name.
@@ -67,7 +62,7 @@ class InstallerManager(IInstallerManager):
 
         Raises
         ------
-        Exception
+        RuntimeError
             If an error occurs during the application setup.
         """
         try:
@@ -81,10 +76,10 @@ class InstallerManager(IInstallerManager):
 
         Raises
         ------
-        Exception
+        RuntimeError
             If an error occurs while displaying information.
         """
         try:
-            self._output.asciiInfo()
+            self._output.printHelp()
         except Exception as e:
-            raise RuntimeError(f"Failed to display information: {e}")
+            raise RuntimeError(f"Failed to display information: {e}")

{orionis-0.196.0 → orionis-0.198.0}/orionis/installer/setup.py

@@ -1,10 +1,10 @@
-import re
 import os
-import sys
+import re
 import shutil
 import subprocess
+import sys
 from unicodedata import normalize
-from orionis.framework import SKELETON, DOCS
+from orionis.framework import DOCS, SKELETON
 from orionis.installer.contracts.output import IInstallerOutput
 from orionis.installer.contracts.setup import IInstallerSetup
 from orionis.luminate.console.output.console import Console

{orionis-0.196.0 → orionis-0.198.0}/orionis/luminate/application.py

@@ -23,15 +23,15 @@ class Application(metaclass=SingletonMeta):
     ----------
     _booted : bool
         Indicates whether the application has been booted.
-    _custom_providers : List[Type[ServiceProvider]]
+    _custom_providers : List[Type[IServiceProvider]]
         Custom service providers defined by the developer.
-    _service_providers : List[Type[ServiceProvider]]
+    _service_providers : List[Type[IServiceProvider]]
         Core application service providers.
-    _config : dict
+    _config : Dict
         Configuration settings of the application.
-    _commands : dict
+    _commands : Dict
         Registered console commands.
-    _env : dict
+    _env : Dict
         Environment variables.
     _container : IContainer
         The service container instance.
@@ -41,8 +41,17 @@ class Application(metaclass=SingletonMeta):
 
     def __init__(self):
         """
-        Initializes the application by setting up service providers, environment variables,
-        configuration, and the service container.
+        Initializes the application by setting up the service container and preparing
+        lists for custom service providers, service providers, configuration, commands,
+        and environment variables.
+        Attributes:
+            _custom_providers (List[Type[IServiceProvider]]): List to store custom service providers.
+            _service_providers (List[Type[IServiceProvider]]): List to store service providers.
+            _config (Dict): Dictionary to store configuration settings.
+            _commands (Dict): Dictionary to store commands.
+            _env (Dict): Dictionary to store environment variables.
+            _container (IContainer): The service container instance.
+        Registers the application instance in the service container.
         """
         self._custom_providers: List[Type[IServiceProvider]] = []
         self._service_providers: List[Type[IServiceProvider]] = []
@@ -57,7 +66,7 @@ class Application(metaclass=SingletonMeta):
     @classmethod
     def boot(cls) -> None:
         """
-        Marks the application as booted.
+        Marks the application as booted by setting the _booted class attribute to True.
         """
         cls._booted = True
 
@@ -69,7 +78,7 @@ class Application(metaclass=SingletonMeta):
         Returns
         -------
         bool
-            True if the application is running, otherwise False.
+            True if the application has been booted, otherwise False.
         """
         return cls._booted
 
@@ -86,28 +95,38 @@ class Application(metaclass=SingletonMeta):
         Raises
         ------
         RuntimeError
-            If the application has not been initialized yet.
+            If the application instance does not exist.
         """
         if cls not in SingletonMeta._instances:
-            raise RuntimeError("Application has not been initialized yet. Please create an instance first.")
+            raise RuntimeError("Application instance does not exist. Please create an instance first.")
         return SingletonMeta._instances[cls]
 
     @classmethod
     def destroy(cls) -> None:
         """
-        Destroys the singleton instance of the Application.
+        Destroys the singleton instance of the application if it exists.
+
+        This method checks if the class has an instance in the SingletonMeta
+        instances dictionary and deletes it if found.
+
+        Returns
+        -------
+        None
         """
         if cls in SingletonMeta._instances:
             del SingletonMeta._instances[cls]
 
     def withProviders(self, providers: List[Type[IServiceProvider]] = None) -> "Application":
         """
-        Sets custom service providers.
-
-        Parameters
-        ----------
-        providers : List[Type[IServiceProvider]], optional
-            List of service providers, by default None.
+        This method allows you to specify a list of custom service providers
+        that will be used by the application. If no providers are specified,
+        an empty list will be used by default.
+            A list of service provider classes to be used by the application.
+            If not provided, defaults to an empty list.
+        Returns
+        -------
+        Application
+            The instance of the Application with the custom service providers set.
         """
         self._custom_providers = providers or []
         return self
@@ -125,25 +144,30 @@ class Application(metaclass=SingletonMeta):
 
     def create(self) -> None:
         """
-        Initializes and boots the application, including loading commands
-        and service providers.
+        Initializes and boots the application.
+        This method performs the following steps:
+        1. Boots the application by calling the `_bootstrapping` method.
+        2. Loads commands and service providers by calling the `_loadCommands` method.
+        3. Boots service providers asynchronously using `AsyncExecutor.run` on the `_bootServiceProviders` method.
+        4. Changes the application status to booted by calling `Application.boot`.
+        Returns
+        -------
+        None
         """
-
-        # Boot the application
         self._bootstrapping()
-
-        # Load commands and service providers
         self._loadCommands()
-
-        # Boot service providers
         AsyncExecutor.run(self._bootServiceProviders())
-
-        # Change the application status to booted
         Application.boot()
 
     async def _bootServiceProviders(self) -> None:
         """
-        Boots all registered service providers.
+        This method iterates over all registered service providers, registers them,
+        and calls their `boot` method if it exists and is callable.
+        Raises
+        ------
+        RuntimeError
+            If an error occurs while booting a service provider, a RuntimeError is raised
+            with a message indicating which service provider failed and the original exception.
         """
         for service in self._service_providers:
             provider: IServiceProvider = service(app=self._container)
@@ -157,8 +181,16 @@ class Application(metaclass=SingletonMeta):
 
     def _bootstrapping(self) -> None:
         """
-        Loads essential components such as environment variables,
-        configurations, commands, and service providers.
+        Initializes and loads essential components for the application.
+        This method sets up the environment variables, configurations, commands,
+        and service providers by utilizing their respective bootstrappers. It
+        iterates through a list of bootstrappers, updating or extending the
+        corresponding properties with the data provided by each bootstrapper.
+        Raises
+        ------
+        BootstrapRuntimeError
+            If an error occurs during the bootstrapping process, an exception is
+            raised with details about the specific bootstrapper that failed.
         """
         bootstrappers = [
             {'property': self._env, 'instance': EnvironmentBootstrapper()},
@@ -182,7 +214,18 @@ class Application(metaclass=SingletonMeta):
 
     def _loadCommands(self) -> None:
         """
-        Registers application commands in the service container.
+        This method iterates over the `_commands` dictionary and registers each command
+        in the service container as a transient service. The command's signature and
+        concrete implementation are retrieved from the dictionary and passed to the
+        container's `transient` method.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        None
         """
         for command, data_command in self._commands.items():
             self._container.transient(data_command.get('signature'), data_command.get('concrete'))

{orionis-0.196.0 → orionis-0.198.0}/orionis/luminate/console/base/command.py

@@ -16,7 +16,7 @@ class BaseCommand(IBaseCommand):
     """
     args = {}
 
-    def success(self, message: str = '', timestamp: bool = True):
+    def success(self, message: str, timestamp: bool = True):
         """
         Prints a success message with a green background.
 
@@ -29,7 +29,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.success(message, timestamp)
 
-    def textSuccess(self, message: str = ''):
+    def textSuccess(self, message: str):
         """
         Prints a success message in green.
 
@@ -40,7 +40,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textSuccess(message)
 
-    def textSuccessBold(self, message: str = ''):
+    def textSuccessBold(self, message: str):
         """
         Prints a bold success message in green.
 
@@ -51,7 +51,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textSuccessBold(message)
 
-    def info(self, message: str = '', timestamp: bool = True):
+    def info(self, message: str, timestamp: bool = True):
         """
         Prints an informational message with a blue background.
 
@@ -64,7 +64,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.info(message, timestamp)
 
-    def textInfo(self, message: str = ''):
+    def textInfo(self, message: str):
         """
         Prints an informational message in blue.
 
@@ -75,7 +75,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textInfo(message)
 
-    def textInfoBold(self, message: str = ''):
+    def textInfoBold(self, message: str):
         """
         Prints a bold informational message in blue.
 
@@ -86,7 +86,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textInfoBold(message)
 
-    def warning(self, message: str = '', timestamp: bool = True):
+    def warning(self, message: str, timestamp: bool = True):
         """
         Prints a warning message with a yellow background.
 
@@ -99,7 +99,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.warning(message, timestamp)
 
-    def textWarning(self, message: str = ''):
+    def textWarning(self, message: str):
         """
         Prints a warning message in yellow.
 
@@ -110,7 +110,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textWarning(message)
 
-    def textWarningBold(self, message: str = ''):
+    def textWarningBold(self, message: str):
         """
         Prints a bold warning message in yellow.
 
@@ -121,7 +121,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textWarningBold(message)
 
-    def fail(self, message: str = '', timestamp: bool = True):
+    def fail(self, message: str, timestamp: bool = True):
         """
         Prints a failure message with a red background.
 
@@ -134,7 +134,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.fail(message, timestamp)
 
-    def error(self, message: str = '', timestamp: bool = True):
+    def error(self, message: str, timestamp: bool = True):
         """
         Prints an error message with a red background.
 
@@ -147,7 +147,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.error(message, timestamp)
 
-    def textError(self, message: str = ''):
+    def textError(self, message: str):
         """
         Prints an error message in red.
 
@@ -158,7 +158,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textError(message)
 
-    def textErrorBold(self, message: str = ''):
+    def textErrorBold(self, message: str):
         """
         Prints a bold error message in red.
 
@@ -169,7 +169,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textErrorBold(message)
 
-    def textMuted(self, message: str = ''):
+    def textMuted(self, message: str):
         """
         Prints a muted (gray) message.
 
@@ -180,7 +180,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textMuted(message)
 
-    def textMutedBold(self, message: str = ''):
+    def textMutedBold(self, message: str):
         """
         Prints a bold muted (gray) message.
 
@@ -191,7 +191,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textMutedBold(message)
 
-    def textUnderline(self, message: str = ''):
+    def textUnderline(self, message: str):
         """
         Prints an underlined message.
 
@@ -214,7 +214,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.clearLine()
 
-    def line(self, message: str = ''):
+    def line(self, message: str):
         """
         Prints a line of text.
 
@@ -236,7 +236,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.newLine(count)
 
-    def write(self, message: str = ''):
+    def write(self, message: str):
         """
         Prints a message without moving to the next line.
 
@@ -247,7 +247,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.write(message)
 
-    def writeLine(self, message: str = ''):
+    def writeLine(self, message: str):
         """
         Prints a message and moves to the next line.
 

{orionis-0.196.0 → orionis-0.198.0}/orionis/luminate/console/commands/help.py

@@ -1,6 +1,7 @@
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 from orionis.luminate.contracts.application import IApplication
+from orionis.framework import NAME
 
 class HelpCommand(BaseCommand):
     """
@@ -35,7 +36,7 @@ class HelpCommand(BaseCommand):
 
             # Display the available commands
             self.newLine()
-            self.textSuccessBold(" (CLI Interpreter) Available Commands: ")
+            self.textSuccessBold(f" ({str(NAME).upper()} CLI Interpreter) Available Commands: ")
 
             # Initialize an empty list to store the rows.
             rows = []

{orionis-0.196.0 → orionis-0.198.0}/orionis/luminate/console/output/console.py

@@ -442,8 +442,8 @@ class Console(IConsole):
         """
 
         errors = ExceptionsToDict.parse(e)
-        error_type = errors.get("error_type").split(".")[-1]
-        error_message = errors.get("error_message").replace(error_type, "").replace("[]", "").strip()
+        error_type = str(errors.get("error_type")).split(".")[-1]
+        error_message = str(errors.get("error_message")).replace(error_type, "").replace("[]", "").strip()
         stack_trace = errors.get("stack_trace")
 
         # Format the output with a more eye-catching appearance

{orionis-0.196.0 → orionis-0.198.0/orionis.egg-info}/PKG-INFO

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