orionis 0.28.0__tar.gz → 0.32.0__tar.gz

{orionis-0.28.0/orionis.egg-info → orionis-0.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: orionis
-Version: 0.28.0
+Version: 0.32.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 → orionis-0.32.0}/orionis/framework.py

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

orionis-0.32.0/orionis/luminate/app.py

@@ -0,0 +1,25 @@
+from orionis.luminate.container.container import Container
+from orionis.luminate.cache.app.config import CacheConfig
+from orionis.luminate.bootstrap.config.register import Register
+from orionis.luminate.bootstrap.config.bootstrapper import Bootstrapper
+
+class App:
+
+    def __init__(self):
+        self.container = Container()
+
+    def start(self):
+        self._register_config_providers()
+        self._resolve_config_providers()
+
+    def finish(self):
+        self.container = None
+
+    def _register_config_providers(self):
+        self.container.singleton(CacheConfig)
+        self.container.singleton(Register)
+        self.container.singleton(Bootstrapper)
+
+    def _resolve_config_providers(self):
+        self.container.make(Register)
+        self.container.make(Bootstrapper)

{orionis-0.28.0 → orionis-0.32.0}/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,43 @@ 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").split(".")[-1]
+        error_message = errors.get("error_message").replace(error_type, "").replace("[]", "").strip()
+        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}"))
+        print(message)
+
+        real_count = len(stack_trace)
+        count_error = real_count
+        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.TEXT_MUTED.value}Trace Call ({count_error}/{real_count}){ANSIColors.TEXT_RESET.value} - {ANSIColors.TEXT_WHITE.value}{filename}:{lineno}{ANSIColors.TEXT_RESET.value}")
+            print(f"  {ANSIColors.DIM.value}{ANSIColors.ITALIC.value}{ANSIColors.TEXT_WARNING.value}{name}{ANSIColors.TEXT_RESET.value} : {ANSIColors.CYAN.value}{line}{ANSIColors.TEXT_RESET.value}")
+            count_error -= 1
+
+        print("▬" * len(f" [{error_type}] : {error_message}"))

{orionis-0.28.0 → orionis-0.32.0}/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-0.28.0 → orionis-0.32.0}/orionis/luminate/container/container.py

@@ -312,7 +312,17 @@ class Container(IContainer):
         OrionisContainerException
             If the service is not found in the container.
         """
-        key = self._aliases.get(abstract, abstract)
+
+        key = abstract
+
+        if isinstance(abstract, str):
+            key = self._aliases.get(key, key)
+
+        if callable(abstract):
+            key = f"{abstract.__module__}.{abstract.__name__}"
+
+        if isinstance(abstract, object) and abstract.__class__.__module__ not in {'builtins', 'abc'}:
+            key = f"{abstract.__class__.__module__}.{abstract.__class__.__name__}"
 
         if key in self._instances:
             return self._instances[key]['instance']

{orionis-0.28.0 → orionis-0.32.0}/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-0.32.0/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-0.32.0/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-0.32.0/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 → orionis-0.32.0/orionis.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: orionis
-Version: 0.28.0
+Version: 0.32.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 → orionis-0.32.0}/orionis.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ orionis.egg-info/requires.txt
 orionis.egg-info/top_level.txt
 orionis/luminate/__init__.py
 orionis/luminate/app.py
+orionis/luminate/orionis.py
 orionis/luminate/bootstrap/__init__.py
 orionis/luminate/bootstrap/cli_exception.py
 orionis/luminate/bootstrap/commands/bootstrapper.py
@@ -114,6 +115,7 @@ orionis/luminate/contracts/publisher/pypi_publisher_interface.py
 orionis/luminate/contracts/test/__init__.py
 orionis/luminate/contracts/test/unit_test_interface.py
 orionis/luminate/contracts/tools/__init__.py
+orionis/luminate/contracts/tools/exception_to_dict_interface.py
 orionis/luminate/contracts/tools/reflection_interface.py
 orionis/luminate/contracts/tools/std_interface.py
 orionis/luminate/facades/__init__.py
@@ -147,6 +149,7 @@ orionis/luminate/test/exception.py
 orionis/luminate/test/unit_test.py
 orionis/luminate/tools/__init__.py
 orionis/luminate/tools/dot_dict.py
+orionis/luminate/tools/exception_to_dict.py
 orionis/luminate/tools/reflection.py
 orionis/luminate/tools/std.py
 tests/__init__.py

orionis-0.28.0/orionis/luminate/app.py

@@ -1,6 +0,0 @@
-from orionis.luminate.container.container import Container
-
-class OrionisApp:
-
-    def __init__(self, config):
-        self.container = Container()