orionis 0.196.0__py3-none-any.whl → 0.198.0__py3-none-any.whl

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/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/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/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/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/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/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.dist-info → orionis-0.198.0.dist-info}/METADATA

@@ -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.dist-info → orionis-0.198.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console.py,sha256=4gYWxf0fWYgJ4RKwARvnTPh06FL3GJ6SAZ7R2NzOICw,1342
-orionis/framework.py,sha256=4uxEdVcciIut5Iim0cdsdXRCMY5k2mIusyFCxEkSbmU,1469
+orionis/framework.py,sha256=SNv_C3vMiGA9gfXNiAV_N1H4a4Ib7DNhq64blJGNTuM,1469
 orionis/installer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/installer/manager.py,sha256=SYP-k_3c2oxFOCCWfMz-wnekWivn3VcFVMUU5e_sJYo,2787
+orionis/installer/manager.py,sha256=Li4TVziRXWfum02xNG4JHwbnLk-u8xzHjdqKz-D894k,2755
 orionis/installer/output.py,sha256=7O9qa2xtXMB_4ZvVi-Klneom9YazwygAd_4uYAoxhbU,8548
-orionis/installer/setup.py,sha256=xP9y84S4OuEp8wrsZInQz3pS8nenIEPQU2sYUrKyJNg,7383
+orionis/installer/setup.py,sha256=w5YBWN_wE_sLQ7cUSXomUgPH5lp5tfqnEfa1MUcFEok,7383
 orionis/installer/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/installer/contracts/manager.py,sha256=Zfndhuyu0JaTKo3PsGsKmVsvotQMw8Pmt4KQp97elY8,1567
 orionis/installer/contracts/output.py,sha256=t1KLw610-hHy63UbFFE2BYwWHWRbW8_ofuEvRLx_IUE,983
 orionis/installer/contracts/setup.py,sha256=aWYkCv-z48bXXZynYapc3uMIE1gyO6XnkTw3b4MTBq4,784
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/application.py,sha256=AzVepXMIzA23NMWMCzZw9F-B-XIV4ik8aZA5rcPBsbE,6966
+orionis/luminate/application.py,sha256=bpZeV8NEHLNm8MkS6suCX3nd7LYB4dOTIgaIivKl2xI,9526
 orionis/luminate/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/config/app.py,sha256=7teuVPuaV2ao0M5Bv-jhSgjEwb9DtVwde2saTRmYru4,1737
 orionis/luminate/config/auth.py,sha256=CG8F0pfVjKz4DY3d1Wi7gscdhnp4TT-Q8SJ2sdsHh18,523
@@ -27,17 +27,17 @@ orionis/luminate/console/command_filter.py,sha256=fmqjQZFwhsEMKWuTtt4dIQF-souVSJ
 orionis/luminate/console/kernel.py,sha256=knzOpbsHJJpAbCSrnFXgRHK9Uk4OisEW_jiylaR-PLA,891
 orionis/luminate/console/parser.py,sha256=jQPDYHvGt-h2qnmDUObaxF9CmuX9YK_8XTYnQwKCSXE,5586
 orionis/luminate/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/base/command.py,sha256=K-Jv3OTVenyrpTI2Jov-WQ435CA4tgqMy6sztxYKDFA,12674
+orionis/luminate/console/base/command.py,sha256=Z5Pk2VhZEv7_0dP4f9Ay4DLX6DV4N78nraX4ty0pQ5g,12579
 orionis/luminate/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/commands/cache_clear.py,sha256=UV2VFFK-LsUNDrqKb_Q8HWnwlwvIuTWTsbQ5x5rWHGk,2859
-orionis/luminate/console/commands/help.py,sha256=3Sc_nXCA9RFiFvvVUkUjVu3CSLit1JSflt2akP7xtN4,2224
+orionis/luminate/console/commands/help.py,sha256=ifo_5KfwI5mokWIvIAqjys2zSGSbudVACITlsSdbOVU,2281
 orionis/luminate/console/commands/schedule_work.py,sha256=eYF94qgNjjAGLoN4JWA0e0zeNWc3fptj2NY2O7KGGGU,2174
 orionis/luminate/console/commands/tests.py,sha256=Z7e6aM5Vu8C7R8iC8sJgUYVN9aJgtVMkqjUEFxPq91o,1281
 orionis/luminate/console/commands/version.py,sha256=llVPK6ELtf8dIdPvLbybrtipWwZkzV0EXc9ShL-C-GY,1140
 orionis/luminate/console/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/exceptions/cli_exception.py,sha256=T5rFjBEXWQf3RbpMb7KDoYayylm5DLPUPLC5OzkZ2-I,4623
 orionis/luminate/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/output/console.py,sha256=URqrEHhsgWk2gOb4G13rCri40uMsihDlSbusYj43NVg,16345
+orionis/luminate/console/output/console.py,sha256=U4Hh1yf6ss9i1uzmMZ3kbOwxyBn4uBr9aem7bnpmB0E,16355
 orionis/luminate/console/output/executor.py,sha256=91722rNiAsKpuq5QYiI7Aqw_7ccmn0DS9KYQrZt0TOs,3369
 orionis/luminate/console/output/progress_bar.py,sha256=ZiPGcUaN3EINeLRKgLGtS1GAb1XWlCDx7wFQ7Ff0hqY,3096
 orionis/luminate/console/output/styles.py,sha256=2e1_FJdNpKaVqmdlCx-udzTleH_6uEFE9_TjH7T1ZUk,3696
@@ -181,9 +181,9 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/class_example.py,sha256=dIPD997Y15n6WmKhWoOFSwEldRm9MdOHTZZ49eF1p3c,1056
 tests/tools/test_reflection.py,sha256=bhLQ7VGVod4B8sv-rW9AjnOumvaBVsoxieA3sdoM2yM,5244
-orionis-0.196.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.196.0.dist-info/METADATA,sha256=vfcxoAZmJMijRSyRLC8Ias0UddJ5WT7csJQPk11XWZc,3003
-orionis-0.196.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.196.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
-orionis-0.196.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.196.0.dist-info/RECORD,,
+orionis-0.198.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.198.0.dist-info/METADATA,sha256=ZnVjxNFfxxQL4cjfoNa9vYE5AymnYuB2I5Q7lFJMebU,3003
+orionis-0.198.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.198.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
+orionis-0.198.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.198.0.dist-info/RECORD,,