orionis 0.457.0__tar.gz → 0.459.0__tar.gz

{orionis-0.457.0/orionis.egg-info → orionis-0.459.0}/PKG-INFO

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

orionis-0.459.0/orionis/console/commands/test.py

@@ -0,0 +1,62 @@
+from orionis.app import Orionis
+from orionis.console.base.command import BaseCommand
+from orionis.console.exceptions import CLIOrionisRuntimeError
+from orionis.test.contracts.kernel import ITestKernel
+
+class TestCommand(BaseCommand):
+    """
+    Command class to display usage information for the Orionis CLI.
+
+    Attributes
+    ----------
+    timestamps : bool
+        Indicates whether timestamps will be shown in the command output.
+    signature : str
+        The command signature.
+    description : str
+        A brief description of the command.
+    """
+
+    # Indicates whether timestamps will be shown in the command output
+    timestamps: bool = False
+
+    # Command signature and description
+    signature: str = "test"
+
+    # Command description
+    description: str = "Prints help information for the Orionis CLI commands."
+
+    def handle(self) -> None:
+        """
+        Executes the test command for the Orionis CLI.
+
+        This method initializes the Orionis application, retrieves the test kernel instance,
+        and runs the test suite using the kernel's handle method. If any exception occurs during
+        execution, it raises a CLIOrionisRuntimeError with the error details.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It performs actions as a side effect,
+            such as running the test suite and handling exceptions.
+
+        Raises
+        ------
+        CLIOrionisRuntimeError
+            If an unexpected error occurs during the execution of the test command.
+        """
+        try:
+
+            # Initialize the Orionis application instance
+            app = Orionis()
+
+            # Retrieve the test kernel instance from the application container
+            kernel: ITestKernel = app.make(ITestKernel)
+
+            # Run the test suite using the kernel's handle method
+            kernel.handle()
+
+        except Exception as e:
+
+            # Raise a CLI-specific runtime error if any exception occurs
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

{orionis-0.457.0 → orionis-0.459.0}/orionis/console/commands/version.py

@@ -6,22 +6,33 @@ from orionis.metadata import framework
 
 class VersionCommand(BaseCommand):
     """
-    Command class to display the current version of the Orionis framework.
+    VersionCommand is a console command that displays the current version and metadata of the Orionis framework.
 
-    This command prints the version number of the framework in use.
+    Attributes
+    ----------
+    timestamps : bool
+        Indicates whether timestamps should be included (default: False).
+    signature : str
+        The command signature used to invoke this command ("version").
+    description : str
+        A brief description of what the command does.
     """
+
+    # Indicates whether timestamps will be shown in the command output
     timestamps: bool = False
 
+    # Command signature and description
     signature: str = "version"
 
+    # Command description
     description: str = "Prints the version of the framework in use."
 
     def handle(self) -> None:
         """
-        Executes the version command to display the current Orionis framework version.
+        Executes the version command to display the current Orionis framework version and metadata.
 
-        This method retrieves the version number from the framework metadata and prints it
-        in a formatted, bold, and successful style to the console. If an unexpected error occurs
+        This method retrieves the version number and additional metadata from the framework module,
+        then prints it in a formatted, styled panel to the console. If an unexpected error occurs
         during execution, it raises a CLIOrionisRuntimeError with the original exception message.
 
         Parameters
@@ -31,7 +42,8 @@ class VersionCommand(BaseCommand):
         Returns
         -------
         None
-            This method does not return any value. It outputs the version information to the console.
+            This method does not return any value. It outputs the version and metadata information
+            to the console using rich formatting.
 
         Raises
         ------
@@ -39,14 +51,11 @@ class VersionCommand(BaseCommand):
             If an unexpected error occurs during execution, a CLIOrionisRuntimeError is raised
             with the original exception message.
         """
-
-        # Print the Orionis framework version in a bold, success style
         try:
-
             # Initialize the console for rich output
             console = Console()
 
-            # Compose the main info
+            # Compose the main information strings using framework metadata
             title = f"[bold yellow]{framework.NAME.capitalize()} Framework[/bold yellow] [white]v{framework.VERSION}[/white]"
             author = f"[bold]Author:[/bold] {framework.AUTHOR}  |  [bold]Email:[/bold] {framework.AUTHOR_EMAIL}"
             desc = f"[italic]{framework.DESCRIPTION}[/italic]"
@@ -54,8 +63,10 @@ class VersionCommand(BaseCommand):
             docs = f"[bold]Docs:[/bold] [underline blue]{framework.DOCS}[/underline blue]"
             repo = f"[bold]Repo:[/bold] [underline blue]{framework.FRAMEWORK}[/underline blue]"
 
+            # Combine all information into the panel body
             body = "\n".join([desc, "", author, python_req, docs, repo, ""])
 
+            # Create a styled panel with the collected information
             panel = Panel(
                 body,
                 title=title,
@@ -65,10 +76,12 @@ class VersionCommand(BaseCommand):
                 subtitle="[bold yellow]Orionis CLI[/bold yellow]",
                 subtitle_align="right"
             )
+
+            # Print a blank line, the panel, and another blank line for spacing
             console.line()
             console.print(panel)
             console.line()
 
-        # Raise a custom runtime error if any exception occurs
         except Exception as e:
+            # Raise a custom runtime error if any exception occurs
             raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

{orionis-0.457.0 → orionis-0.459.0}/orionis/console/core/reactor.py

@@ -102,11 +102,13 @@ class Reactor(IReactor):
         # Import the core command class for version
         from orionis.console.commands.version import VersionCommand
         from orionis.console.commands.help import HelpCommand
+        from orionis.console.commands.test import TestCommand
 
         # List of core command classes to load (extend this list as more core commands are added)
         core_commands = [
             VersionCommand,
-            HelpCommand
+            HelpCommand,
+            TestCommand
         ]
 
         # Iterate through the core command classes and register them

{orionis-0.457.0 → orionis-0.459.0}/orionis/console/kernel.py

@@ -3,6 +3,7 @@ from orionis.console.contracts.reactor import IReactor
 from orionis.console.output.contracts.console import IConsole
 from orionis.foundation.contracts.application import IApplication
 from orionis.console.exceptions import CLIOrionisValueError
+from orionis.services.log.contracts.log_service import ILogger
 
 class KernelCLI(IKernelCLI):
 
@@ -42,6 +43,9 @@ class KernelCLI(IKernelCLI):
         # Retrieve and initialize the console instance for command output and error handling.
         self.__console: IConsole = app.make('x-orionis.console.output.console')
 
+        # Initialize the logger service for logging command execution details
+        self.__logger: ILogger = app.make('x-orionis.services.log.log_service')
+
     def handle(self, args: list) -> None:
         """
         Processes and dispatches command line arguments to the appropriate command handler.
@@ -90,10 +94,16 @@ class KernelCLI(IKernelCLI):
 
         except SystemExit as e:
 
+            # Log the SystemExit exception for debugging purposes
+            self.__logger.error(f"SystemExit encountered: {str(e)}")
+
             # Handle SystemExit exceptions gracefully, allowing for clean exits with error messages
             self.__console.exitError(str(e))
 
         except Exception as e:
 
+            # Log any unexpected exceptions that occur during command processing
+            self.__logger.error(f"An unexpected error occurred while processing command: {str(e)}")
+
             # Handle any other exceptions that may occur during command processing
             self.__console.exitError(f"An unexpected error occurred: {str(e)}")

{orionis-0.457.0 → orionis-0.459.0}/orionis/metadata/framework.py

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

{orionis-0.457.0 → orionis-0.459.0}/orionis/test/kernel.py

@@ -1,5 +1,6 @@
 from orionis.console.output.contracts.console import IConsole
 from orionis.foundation.contracts.application import IApplication
+from orionis.services.log.contracts.log_service import ILogger
 from orionis.test.contracts.kernel import ITestKernel
 from orionis.test.contracts.unit_test import IUnitTest
 from orionis.foundation.config.testing.entities.testing import Testing
@@ -70,6 +71,9 @@ class TestKernel(ITestKernel):
         # Resolve the console service from the application container
         self.__console: IConsole = app.make('x-orionis.console.output.console')
 
+        # Initialize the logger service for logging command execution details
+        self.__logger: ILogger = app.make('x-orionis.services.log.log_service')
+
     def handle(self) -> IUnitTest:
         """
         Execute the unit test suite and handle any exceptions that occur during testing.
@@ -94,12 +98,37 @@ class TestKernel(ITestKernel):
 
         # Execute the unit test suite through the injected unit test service
         try:
-            return self.__unit_test.run()
+
+            # Log the start of test execution
+            ouput = self.__unit_test.run()
+
+            # Extract report details from output
+            total_tests = ouput.get("total_tests")
+            passed = ouput.get("passed")
+            failed = ouput.get("failed")
+            errors = ouput.get("errors")
+            skipped = ouput.get("skipped")
+            total_time = ouput.get("total_time")
+            success_rate = ouput.get("success_rate")
+            timestamp = ouput.get("timestamp")
+
+            # Log test execution completion with detailed summary
+            self.__logger.info(
+                f"Test execution completed at {timestamp} | "
+                f"Total: {total_tests}, Passed: {passed}, Failed: {failed}, "
+                f"Errors: {errors}, Skipped: {skipped}, "
+                f"Time: {total_time:.2f}s, Success rate: {success_rate:.2f}%"
+            )
+
+            # Report the test results to the console
+            return ouput
 
         # Handle expected test failures with a descriptive error message
         except OrionisTestFailureException as e:
+            self.__logger.error(f"Test execution failed: {e}")
             self.__console.exitError(f"Test execution failed: {e}")
 
         # Handle any unexpected errors that occur during test execution
         except Exception as e:
+            self.__logger.error(f"An unexpected error occurred while executing tests: {e}")
             self.__console.exitError(f"An unexpected error occurred: {e}")

{orionis-0.457.0 → orionis-0.459.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.457.0 → orionis-0.459.0}/orionis.egg-info/SOURCES.txt

@@ -22,6 +22,7 @@ orionis/console/base/contracts/__init__.py
 orionis/console/base/contracts/command.py
 orionis/console/commands/__init__.py
 orionis/console/commands/help.py
+orionis/console/commands/test.py
 orionis/console/commands/version.py
 orionis/console/contracts/__init__.py
 orionis/console/contracts/kernel.py