orionis 0.456.0__py3-none-any.whl → 0.458.0__py3-none-any.whl

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/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/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/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/foundation/providers/logger_provider.py

@@ -54,11 +54,7 @@ class LoggerProvider(ServiceProvider):
         logger_service = Logger(logging_config)
 
         # Register the service instance in the container with interface binding and alias
-        self.app.instance(
-            ILogger,                             # Interface contract
-            logger_service,                             # Concrete implementation instance
-            alias="x-orionis.services.log.log_service"  # Internal framework alias
-        )
+        self.app.instance(ILogger, logger_service, alias="x-orionis.services.log.log_service")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/reactor_provider.py

@@ -57,11 +57,7 @@ class ReactorProvider(ServiceProvider):
 
         # Register the Reactor service with the application container
         # as a singleton, allowing it to be resolved throughout the application lifecycle
-        self.app.singleton(
-            IReactor,
-            Reactor,
-            alias="x-orionis.console.core.reactor"
-        )
+        self.app.singleton(IReactor, Reactor, alias="x-orionis.console.core.reactor")
 
     def boot(self) -> None:
         """

orionis/foundation/providers/workers_provider.py

@@ -57,11 +57,7 @@ class WorkersProvider(ServiceProvider):
         - Suitable for stateless or short-lived worker operations
         """
 
-        self.app.transient(
-            IWorkers,  # The interface contract that defines worker operations
-            Workers,   # The concrete implementation class
-            alias="x-orionis.services.system.workers"  # Descriptive alias for container lookup
-        )
+        self.app.transient(IWorkers, Workers, alias="x-orionis.services.system.workers")
 
     def boot(self) -> None:
         """

orionis/metadata/framework.py

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

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

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

{orionis-0.456.0.dist-info → orionis-0.458.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/app.py,sha256=b69fOzj2J8Aw5g0IldWZXixUDeeTO9vcHc_Njses9HU,603
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/kernel.py,sha256=NGiINJzYRpxjQslZeELxxySxI-tL_isRrUL0yn4uz5o,3942
+orionis/console/kernel.py,sha256=xmESoZiQXXBufZipwNxc6MFkEiEUB4uyCbx6dR7w1Hg,4492
 orionis/console/args/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/args/argument.py,sha256=Is8Z8_kW4DvcK1nK1UU-sa6Pk0BeOdcRczCayW0ZVHc,20360
 orionis/console/args/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -12,12 +12,13 @@ orionis/console/base/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5
 orionis/console/base/contracts/command.py,sha256=vmAJD0yMQ5-AD_s9_xCFEAl64sKk65z7U2E196dALQM,5760
 orionis/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/commands/help.py,sha256=EGg5FfWnLasi7I7gCTBLyvau6I0gVpc2ewNefyJlHeE,1494
-orionis/console/commands/version.py,sha256=0neKUq7MulO0hLZyU9LLfIQYEaQtnm3faIjIfeK52V8,2886
+orionis/console/commands/test.py,sha256=TgiK-6s23ZEiSdUekdngmpcmoqZYGcy8F7YoX-afk3Y,2151
+orionis/console/commands/version.py,sha256=NhLzMrr022mIY4C4SjX_FfKNDXWfIPyWAqzpx_9Hi2k,3547
 orionis/console/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/contracts/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01IIHI5Y,826
 orionis/console/contracts/reactor.py,sha256=fT49-794RI-y0ZhDyXf91VQoFdGx6kF1Kg-monJnj7s,1296
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=DoloMbAw7WojH38rSKmrRAArl8rWVb5J_p1YLepUMpc,21619
+orionis/console/core/reactor.py,sha256=0d-2Gp3PGoLQeDZwZemKnRjQaAs0O8O3cb2GZnm8OkA,21708
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/dump.py,sha256=CATERiQ6XuIrKQsDaWcVxzTtlAJI9qLJX44fQxEX8ws,22443
 orionis/console/dumper/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -177,13 +178,13 @@ orionis/foundation/providers/console_provider.py,sha256=9oDHOGm79O8OtwTFPCYl4hNQ
 orionis/foundation/providers/dumper_provider.py,sha256=nKHjLDClCo-KnPloh6EYVySjgzf6SYSvoxVD6IwJt8M,3355
 orionis/foundation/providers/executor_provider.py,sha256=kwkH8YWEXoEoP51akJXQJ0U25rhlOLxnfE0s9fALr0I,3478
 orionis/foundation/providers/inspirational_provider.py,sha256=uq2o0uLd5p6PR99uH4cJAcc6NnU6nIOwe0ZIdzZcF4Q,3726
-orionis/foundation/providers/logger_provider.py,sha256=bEJug46TNNxuqfCI8eI-GSp0eyNromvBDszQGK-0roc,3607
+orionis/foundation/providers/logger_provider.py,sha256=rs8UpaD_vSp3qNli0u9A4eRum3q3F0KEM0V6yhcl2GU,3417
 orionis/foundation/providers/progress_bar_provider.py,sha256=X4Ke7mPr0MgVp6WDNaQ3bI3Z_LOS8qE-wid0MQErKms,3367
-orionis/foundation/providers/reactor_provider.py,sha256=g7X5eyZviQkX2hD7jZof6h1hZmN8rNvODmhGFysfiEY,3712
+orionis/foundation/providers/reactor_provider.py,sha256=P0KQcp4AFKTrD6BStGfCTqhGUlpKgsrZTZZKSqyGJQg,3662
 orionis/foundation/providers/testing_provider.py,sha256=SrJRpdvcblx9WvX7x9Y3zc7OQfiTf7la0HAJrm2ESlE,3725
-orionis/foundation/providers/workers_provider.py,sha256=5CvlUETdIblh7Wx8pT0MswTeTCGhYah-EvFqOrLu8Mo,4113
+orionis/foundation/providers/workers_provider.py,sha256=oa_2NIDH6UxZrtuGkkoo_zEoNIMGgJ46vg5CCgAm7wI,3926
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=F5pE_UIelgIj5tk73nlMNZoqHahNmXnoQAl4vkJJjmg,4088
+orionis/metadata/framework.py,sha256=7YBgAPpg_ZsJ7stxuL9Lqnyh5ZLsIHGHL1rxkATjHmM,4088
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -301,7 +302,7 @@ orionis/support/standard/exceptions/value.py,sha256=rsyWFQweImaJGTJa7Id7RhPlwWJ4
 orionis/support/wrapper/__init__.py,sha256=jGoWoIGYuRYqMYQKlrX7Dpcbg-AGkHoB_aM2xhu73yc,62
 orionis/support/wrapper/dot_dict.py,sha256=T8xWwwOhBZHNeXRwE_CxvOwG9UFxsLqNmOJjV2CNIrc,7284
 orionis/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/kernel.py,sha256=iFJh72_YHPzQbeFyOJWU4R9vfWohfElLRU17Ak_Vhos,5024
+orionis/test/kernel.py,sha256=gJuQkd76T3c_iXFpHHmGrOjH8A6xe8esH6SwEAKF--4,6362
 orionis/test/cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/cases/asynchronous.py,sha256=3e1Y3qzIxVU7i7lbLFEVyJ89IA74JsB7famx71W-p2E,1974
 orionis/test/cases/synchronous.py,sha256=S5jhuDEZ5I9wosrTFaCtowkD5r5HzJH6mKPOdEJcDJE,1734
@@ -348,7 +349,7 @@ orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNu
 orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=f-zNhtKSg9R5Njqujbg2l2amAs2-mRVESneLIkWOZjU,4082
-orionis-0.456.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.458.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -491,8 +492,8 @@ tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 tests/testing/validators/test_testing_validators.py,sha256=WPo5GxTP6xE-Dw3X1vZoqOMpb6HhokjNSbgDsDRDvy4,16588
 tests/testing/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/view/test_render.py,sha256=tnnMBwS0iKUIbogLvu-7Rii50G6Koddp3XT4wgdFEYM,1050
-orionis-0.456.0.dist-info/METADATA,sha256=CuJ0cT18-oNIn-451hxfWvnoA4an7SVDx3Lv9uTvSY4,4772
-orionis-0.456.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.456.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.456.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.456.0.dist-info/RECORD,,
+orionis-0.458.0.dist-info/METADATA,sha256=p8UY8y_1pRk9-SkzSGK3IaqBKZxKpvwuhIDm5ugAHYg,4772
+orionis-0.458.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.458.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.458.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.458.0.dist-info/RECORD,,