orionis 0.28.0__py3-none-any.whl → 0.30.0__py3-none-any.whl

orionis/framework.py

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

orionis/luminate/app.py

@@ -1,6 +1,36 @@
 from orionis.luminate.container.container import Container
 
-class OrionisApp:
+class App:
 
-    def __init__(self, config):
-        self.container = Container()
+    def __init__(self):
+        # Inicializa el contenedor de dependencias
+        self.container = Container()
+
+    def start(self):
+        pass
+
+    def finish(self):
+        pass
+
+    def in_context(self):
+        """Método placeholder para gestionar el contexto de la aplicación"""
+        pass
+
+    def register_service_providers(self):
+        """
+        Registra los proveedores de servicios en el contenedor.
+        Carga y registra los servicios de forma perezosa.
+        """
+        # Importación perezosa de los servicios
+        from orionis.luminate.cache.app.config import CacheConfig
+        from orionis.luminate.bootstrap.config.register import Register
+        from orionis.luminate.bootstrap.config.bootstrapper import Bootstrapper
+
+        # Registro de servicios esenciales en el contenedor
+        self.container.singleton(CacheConfig)  # Configuración del cache
+        self.container.singleton(Register)    # Registro de la configuración de la app
+        self.container.singleton(Bootstrapper)  # Inicialización del sistema
+
+    def load_config(self):
+        """Método placeholder para cargar la configuración de la aplicación"""
+        pass

orionis/luminate/console/output/console.py

@@ -4,6 +4,7 @@ import getpass
 import datetime
 from orionis.luminate.console.output.styles import ANSIColors
 from orionis.luminate.contracts.console.output.console_interface import IConsole
+from orionis.luminate.tools.exception_to_dict import ExceptionsToDict
 
 class Console(IConsole):
     """
@@ -424,3 +425,39 @@ class Console(IConsole):
             answer = input("Please select a valid number: ").strip()
 
         return choices[int(answer) - 1]
+
+    @staticmethod
+    def exception(e) -> None:
+        """
+        Prints an exception message with detailed information.
+
+        Parameters
+        ----------
+        exception : Exception
+            The exception to print.
+
+        Notes
+        -----
+        This method prints the exception type, message, and a detailed stack trace.
+        """
+
+        errors = ExceptionsToDict.parse(e)
+        error_type = errors.get("error_type")
+        error_message = errors.get("error_message")
+        stack_trace = errors.get("stack_trace")
+
+        # Format the output with a more eye-catching appearance
+        message = f"{ANSIColors.BG_ERROR.value}{ANSIColors.TEXT_WHITE.value} [{error_type}] {ANSIColors.TEXT_RESET.value}: {ANSIColors.TEXT_WARNING.value}{error_message}{ANSIColors.TEXT_RESET.value}"
+        print("-" * len(f" [{error_type}] : {error_message}"))  # separator line
+        print(message)
+
+        for frame in stack_trace:
+            filename = frame["filename"]
+            lineno = frame["lineno"]
+            name = frame["name"]
+            line = frame["line"]
+
+            # Print the stack trace with enhanced styling
+            print(f"{ANSIColors.CYAN.value}{ANSIColors.DIM.value}  {ANSIColors.MAGENTA.value}{ANSIColors.TEXT_BOLD.value}{filename}:{ANSIColors.TEXT_BOLD.value}{lineno}{ANSIColors.TEXT_RESET.value} / {ANSIColors.DIM.value}{ANSIColors.ITALIC.value}{ANSIColors.TEXT_WARNING.value}{name}{ANSIColors.TEXT_RESET.value} / {ANSIColors.CYAN.value}{line}{ANSIColors.TEXT_RESET.value}")
+
+        print("-" * len(f" [{error_type}] : {error_message}"))

orionis/luminate/console/output/styles.py

@@ -93,3 +93,7 @@ class ANSIColors(Enum):
     TEXT_BOLD = "\033[1m"               # Bold text
     TEXT_STYLE_UNDERLINE = '\033[4m'    # Underline text
     TEXT_RESET = "\033[0m"              # Reset styles
+    CYAN = "\033[36m"
+    DIM = "\033[2m"
+    MAGENTA = "\033[35m"
+    ITALIC = "\033[3m"

orionis/luminate/contracts/console/output/console_interface.py

@@ -302,4 +302,20 @@ class IConsole(ABC):
         one by entering the corresponding number. If an invalid input is provided,
         the user will be repeatedly prompted until a valid choice is made.
         """
+        pass
+
+    @abstractmethod
+    def exception(e) -> None:
+        """
+        Prints an exception message with detailed information.
+
+        Parameters
+        ----------
+        exception : Exception
+            The exception to print.
+
+        Notes
+        -----
+        This method prints the exception type, message, and a detailed stack trace.
+        """
         pass

orionis/luminate/contracts/tools/exception_to_dict_interface.py

@@ -0,0 +1,35 @@
+from abc import ABC, abstractmethod
+
+class IExceptionsToDict(ABC):
+    """
+    A utility class to parse an exception and convert it into a structured dictionary.
+
+    Methods
+    -------
+    parse(exception: Exception) -> dict
+        Converts an exception into a dictionary containing the error type, message, 
+        and stack trace information.
+    """
+
+    @abstractmethod
+    def parse(exception):
+        """
+        Parse the provided exception and serialize it into a dictionary format.
+
+        Parameters
+        ----------
+        exception : Exception
+            The exception object to be serialized.
+
+        Returns
+        -------
+        dict
+            A dictionary containing the exception details such as error type, message,
+            and the stack trace.
+
+        Notes
+        -----
+        - Uses `traceback.TracebackException.from_exception()` to extract detailed traceback information.
+        - The stack trace includes filenames, line numbers, function names, and the exact line of code.
+        """
+        pass

orionis/luminate/orionis.py

@@ -0,0 +1,111 @@
+import traceback
+from orionis.luminate.app import App
+
+class OrionisContext:
+    """
+    Context manager for the Orionis application that handles startup and cleanup.
+
+    This class manages the lifecycle of an Orionis application instance.
+    It starts the application when entering the context and ensures that the
+    application is properly finished when exiting, capturing any exceptions that occur.
+
+    Attributes
+    ----------
+    is_started : bool
+        Flag indicating whether the application has been successfully started.
+    app : App
+        Instance of the Orionis application.
+    error_info : tuple or None
+        Tuple containing the exception instance and its formatted traceback if an error occurs;
+        otherwise, None.
+    """
+
+    def __init__(self):
+        """
+        Initialize the OrionisContext.
+
+        Sets up the application instance and initializes state variables.
+        """
+        self.is_started = False
+        self.app = App()
+        self.error_info = None
+
+    def __enter__(self):
+        """
+        Enter the runtime context and start the application.
+
+        Attempts to start the Orionis application. If successful, sets the active flag
+        and returns the context instance. If an exception is raised during startup,
+        captures the exception and its traceback before re-raising it.
+
+        Returns
+        -------
+        OrionisContext
+            The current context instance with the application started.
+
+        Raises
+        ------
+        Exception
+            Re-raises any exception that occurs during the application startup.
+        """
+        try:
+            self.app.start()
+            self.is_started = True
+            return self
+        except Exception as e:
+            self.error_info = (e, traceback.format_exc())
+            raise
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """
+        Exit the runtime context and finish the application.
+
+        Calls the application's finish method to perform cleanup regardless of whether
+        an exception occurred. If an exception occurred, captures its information and
+        returns False to indicate that the exception should not be suppressed.
+
+        Parameters
+        ----------
+        exc_type : type
+            The type of the exception raised (if any).
+        exc_val : Exception
+            The exception instance raised (if any).
+        exc_tb : traceback
+            The traceback associated with the exception (if any).
+
+        Returns
+        -------
+        bool
+            Always returns False so that any exception is propagated.
+        """
+        try:
+            self.app.finish()
+        finally:
+            self.is_started = False
+
+        if exc_type:
+            self.error_info = (exc_val, traceback.format_exc())
+            return False
+
+    def is_active(self):
+        """
+        Check if the application is currently active.
+
+        Returns
+        -------
+        bool
+            True if the application has been started and is active, False otherwise.
+        """
+        return self.is_started
+
+    def get_error(self):
+        """
+        Retrieve the stored error information.
+
+        Returns
+        -------
+        tuple or None
+            A tuple containing the exception and its formatted traceback if an error occurred;
+            otherwise, None.
+        """
+        return self.error_info

orionis/luminate/tools/exception_to_dict.py

@@ -0,0 +1,52 @@
+from orionis.luminate.contracts.tools.exception_to_dict_interface import IExceptionsToDict
+import traceback
+
+class ExceptionsToDict(IExceptionsToDict):
+    """
+    A utility class to parse an exception and convert it into a structured dictionary.
+
+    Methods
+    -------
+    parse(exception: Exception) -> dict
+        Converts an exception into a dictionary containing the error type, message,
+        and stack trace information.
+    """
+
+    @staticmethod
+    def parse(exception):
+        """
+        Parse the provided exception and serialize it into a dictionary format.
+
+        Parameters
+        ----------
+        exception : Exception
+            The exception object to be serialized.
+
+        Returns
+        -------
+        dict
+            A dictionary containing the exception details such as error type, message,
+            and the stack trace.
+
+        Notes
+        -----
+        - Uses `traceback.TracebackException.from_exception()` to extract detailed traceback information.
+        - The stack trace includes filenames, line numbers, function names, and the exact line of code.
+        """
+        # Extract the detailed traceback information from the exception
+        tb = traceback.TracebackException.from_exception(exception)
+
+        # Construct and return the dictionary containing all necessary exception details
+        return {
+            "error_type": tb.exc_type_str,  # Using `exc_type_str` to avoid deprecation warnings
+            "error_message": str(tb),  # A string representation of the entire traceback message
+            "stack_trace": [
+                {
+                    "filename": frame.filename,  # The source file of the frame
+                    "lineno": frame.lineno,      # The line number where the exception occurred
+                    "name": frame.name,          # The function name
+                    "line": frame.line           # The line of code in the frame
+                }
+                for frame in tb.stack  # Iterating over each frame in the traceback stack
+            ]
+        }

{orionis-0.28.0.dist-info → orionis-0.30.0.dist-info}/METADATA

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

{orionis-0.28.0.dist-info → orionis-0.30.0.dist-info}/RECORD

@@ -1,8 +1,9 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=9wNVJxB0HyqUbNesUvkwlsqTyUbZwK6R46iVLE5WVBQ,1715
-orionis/framework.py,sha256=WHstU04TC0Eu1ERcwcS3aezpOkpNEpwej2zUM870jns,1386
+orionis/framework.py,sha256=xtmJazlCIPVp_r-jU-eWaI19VnVIrsyHVtGbaEm1o2o,1386
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/app.py,sha256=fh5p0w5VBb0zJ6qKNHOCs2vxIix6AborENZFW_GCvrw,152
+orionis/luminate/app.py,sha256=4exLRx5qKyHz9aeb0DCZMcbUe0gDGuKP5lt2AfkrB10,1290
+orionis/luminate/orionis.py,sha256=VM6YgIBZBu6WU7Tv5i22wbuIhWVJsDrtDxokBP169o8,3512
 orionis/luminate/bootstrap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/bootstrap/cli_exception.py,sha256=wDKfEW295c7-bavr7YUHK2CLYcTSZgjT9ZRSBne6GOE,1356
 orionis/luminate/bootstrap/commands/bootstrapper.py,sha256=TuXuQUzeaiDL8sJyZNdqnFl2h2MfxcnSU045IeIKVQE,4016
@@ -47,10 +48,10 @@ orionis/luminate/console/commands/version.py,sha256=oM5Vr_2Xc7Eaq6VHbcMaTeteY0cD
 orionis/luminate/console/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/exceptions/cli_exception.py,sha256=QM7tRdPBoo7WdmAb3Zasj8d3429zskftUGYHAvhcnSU,4631
 orionis/luminate/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/output/console.py,sha256=KTQKMpVVOdCsGUxrKRSQzlqmz42wwWV-8b14q_mfrYI,14481
+orionis/luminate/console/output/console.py,sha256=61rMbYQHmQxzt2cZdX9Sz6y9TidqDiDfrPFXghky8Rg,16178
 orionis/luminate/console/output/executor.py,sha256=J4lmWMRCXW2b5L8PbX31q1fGnnjYZOO93O4rtPyA_0A,3379
 orionis/luminate/console/output/progress_bar.py,sha256=YT8Gl-_Zfc3E6foU-Dw7aAndZm4m-xY36G3MpPi3Aj4,3106
-orionis/luminate/console/output/styles.py,sha256=fF_B1kw95lkiLUzq4cjYPppF-sLsx9_qmyhKqoeZrJ0,3604
+orionis/luminate/console/output/styles.py,sha256=2e1_FJdNpKaVqmdlCx-udzTleH_6uEFE9_TjH7T1ZUk,3696
 orionis/luminate/console/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/scripts/management.py,sha256=J5gLXtvX8I1zdNk6sa23njR18D5s4LJXZK7ElK0sFzI,2868
 orionis/luminate/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -78,7 +79,7 @@ orionis/luminate/contracts/console/parser_interface.py,sha256=vMmTK0wMfTjt7H-tRf
 orionis/luminate/contracts/console/runner_interface.py,sha256=vWLtMhl0m1T6rfCUHZbxGQJl9ZWTXlp3HjcTfCAztGk,1644
 orionis/luminate/contracts/console/task_manager_interface.py,sha256=sOmeifoncpWCG2WYh4q3QZ7M7w7P9Onb3Jxw9X2lpXE,1197
 orionis/luminate/contracts/console/base/base_command_interface.py,sha256=Lz0ktEjeXcqU5803BVIDT8H3fhbvfkd3Ngsa561lrZY,12241
-orionis/luminate/contracts/console/output/console_interface.py,sha256=NL6GsbJy286y0wcWhAhqavC6G2EW_WZJYQdH9wMO8Vc,8517
+orionis/luminate/contracts/console/output/console_interface.py,sha256=bkYTT5oIK3NP-p7XONgi1z_SO50ZvJu31Nv7cjs4t7s,8902
 orionis/luminate/contracts/console/output/executor_interface.py,sha256=MGMTTPSwF8dgCjHD3A4CKtYDaCcD-KU28dorC61Q04k,1411
 orionis/luminate/contracts/console/output/progress_bar_interface.py,sha256=sOkQzQsliFemqZHMyzs4fWhNJfXDTk5KH3aExReetSE,1760
 orionis/luminate/contracts/console/scripts/management_interface.py,sha256=4Zc8da5iz3kHZju61A0krArKVZ5K39B0Imk1GmgTMks,1586
@@ -104,6 +105,7 @@ orionis/luminate/contracts/publisher/pypi_publisher_interface.py,sha256=u0mEMbli
 orionis/luminate/contracts/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/test/unit_test_interface.py,sha256=F6jKKZcpQ94acqpbUjPwSOZGJB7McD5hHH1lStqL9Go,1486
 orionis/luminate/contracts/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/contracts/tools/exception_to_dict_interface.py,sha256=rCuhx2tmUgT4flpsyw4tLnjMbrVTURbADUQxC16cCgA,1079
 orionis/luminate/contracts/tools/reflection_interface.py,sha256=k9y7So3Z-_QFBBaCl-4t50ZRixt1pcxPtpwlo1NrSGk,8140
 orionis/luminate/contracts/tools/std_interface.py,sha256=VtOlmz7c1llBRVzKnEBA4aJE5m0Y0w7pFJ_1TgG1-G0,1408
 orionis/luminate/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -137,15 +139,16 @@ orionis/luminate/test/exception.py,sha256=VJaZ7VMZfdKW1ov_GwKp2HAz_NYobujJxDt5Ra
 orionis/luminate/test/unit_test.py,sha256=3zemWa150SfxcXhs1n1TjYvbfLgwqJjhwFPnUlLLtgg,3738
 orionis/luminate/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/tools/dot_dict.py,sha256=FVHfBuAGTTVMjNG01Fix645fRNKKUMmNx61pYkxPL5c,1253
+orionis/luminate/tools/exception_to_dict.py,sha256=ylnLmn5W7EW8b_gZrB6MwwNHqdbVqhdLdKtR1gNakKo,2113
 orionis/luminate/tools/reflection.py,sha256=3G4nZIE73LDtGJLlq9U_P9O2FnTi5-wr9s00CVAmjFw,11959
 orionis/luminate/tools/std.py,sha256=wquV7xgT1tvSRpbrq5h_GQwCof9cXjen-vuWPubAKbs,1398
 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=dNN5p_xAosyEf0ddAElmmmTfhcTtBd4zBNl7qzgnsc0,5242
-orionis-0.28.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.28.0.dist-info/METADATA,sha256=jepvvgXCSy0qQh6y-8GLj4k4dAWirOX7Xq8SxrmFBjQ,2978
-orionis-0.28.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.28.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.28.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.28.0.dist-info/RECORD,,
+orionis-0.30.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.30.0.dist-info/METADATA,sha256=PsyKM0V1nld_HPgnrK97KGWIBmxLNxuizjJaMfTeFWc,2978
+orionis-0.30.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.30.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.30.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.30.0.dist-info/RECORD,,