orionis 0.427.0__py3-none-any.whl → 0.428.0__py3-none-any.whl

orionis/console/commands/version.py

@@ -0,0 +1,31 @@
+from orionis.console.base.command import BaseCommand
+from orionis.console.exceptions import CLIOrionisRuntimeError
+from orionis.metadata.framework import VERSION
+
+class VersionCommand(BaseCommand):
+    """
+    Command class to display the current version of the Orionis framework.
+
+    This command prints the version number of the framework in use.
+    """
+
+    signature = "version"
+
+    description = "Prints the version of the framework in use."
+
+    def handle(self) -> None:
+        """
+        Execute the version command.
+
+        This method retrieves and prints the version of the Orionis framework.
+
+        Raises
+        ------
+        ValueError
+            If an unexpected error occurs during execution, a ValueError is raised
+            with the original exception message.
+        """
+        try:
+            self.textSuccessBold(f"Orionis Framework v{VERSION}")
+        except Exception as e:
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/console/contracts/kernel.py

@@ -0,0 +1,15 @@
+from abc import ABC, abstractmethod
+
+class IKernelCLI(ABC):
+    """
+    Interface for the Kernel CLI.
+    """
+
+    @abstractmethod
+    def handle(self, args: list) -> None:
+        """
+        Handle the command line arguments.
+
+        :param args: List of command line arguments (e.g., sys.argv).
+        """
+        raise NotImplementedError("This method should be overridden by subclasses.")

orionis/console/exceptions/__init__.py

@@ -0,0 +1,11 @@
+from .cli_exception import CLIOrionisException
+from .cli_runtime_error import CLIOrionisRuntimeError
+from .cli_schedule_exception import CLIOrionisScheduleException
+from .cli_orionis_value_error import CLIOrionisValueError
+
+__all__ = [
+    'CLIOrionisException',
+    'CLIOrionisRuntimeError',
+    'CLIOrionisScheduleException',
+    'CLIOrionisValueError'
+]

orionis/console/kelnel.py

@@ -0,0 +1,25 @@
+from orionis.console.contracts.kernel import IKernelCLI
+from orionis.foundation.contracts.application import IApplication
+from orionis.console.exceptions import CLIOrionisValueError
+
+class KernelCLI(IKernelCLI):
+
+    def __init__(
+        self,
+        app: IApplication
+    ) -> None:
+
+        # Validate that the app is an instance of IApplication
+        if not isinstance(app, IApplication):
+            raise CLIOrionisValueError(
+                f"Failed to initialize TestKernel: expected IApplication, got {type(app).__module__}.{type(app).__name__}."
+            )
+
+    def handle(self, args: list) -> None:
+        """
+        Handle the command line arguments.
+
+        :param args: List of command line arguments (e.g., sys.argv).
+        """
+        # This method should be implemented in subclasses
+        print(args)

orionis/foundation/application.py

@@ -114,10 +114,12 @@ class Application(Container, IApplication):
 
         # Import core framework kernels
         from orionis.test.kernel import TestKernel, ITestKernel
+        from orionis.console.kelnel import KernelCLI, IKernelCLI
 
         # Core framework kernels
         core_kernels = {
-            ITestKernel: TestKernel
+            ITestKernel: TestKernel,
+            IKernelCLI: KernelCLI
         }
 
         # Register each kernel instance
@@ -1255,7 +1257,7 @@ class Application(Container, IApplication):
 
         # Return the entire configuration if key is None, except for paths
         if key is None:
-            del self.__config['paths']
+            del self.__config['path']
             return self.__config
 
         # If key is None, raise an error to prevent ambiguity

orionis/metadata/framework.py

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

orionis/test/kernel.py

@@ -2,11 +2,12 @@ from pathlib import Path
 import re
 from typing import List
 from os import walk
+from orionis.console.output.contracts.console import IConsole
 from orionis.foundation.config.testing.entities.testing import Testing
 from orionis.foundation.contracts.application import IApplication
 from orionis.test.contracts.kernel import ITestKernel
 from orionis.test.contracts.unit_test import IUnitTest
-from orionis.test.exceptions import OrionisTestConfigException
+from orionis.test.exceptions import OrionisTestConfigException, OrionisTestFailureException
 
 class TestKernel(ITestKernel):
 
@@ -42,6 +43,9 @@ class TestKernel(ITestKernel):
         self.__unit_test._UnitTest__app = app
         self.__unit_test._UnitTest__storage = app.path('storage_testing')
 
+        # Initialize the console for output
+        self.__console: IConsole = app.make('core.orionis.console')
+
     def __listMatchingFolders(
         self,
         base_path: Path,
@@ -92,54 +96,65 @@ class TestKernel(ITestKernel):
         IUnitTest
             The configured and executed unit test instance.
         """
+        try:
+
+            # Configure the unit test with parameters from the configuration
+            self.__unit_test.configure(
+                verbosity=self.__config.verbosity,
+                execution_mode=self.__config.execution_mode,
+                max_workers=self.__config.max_workers,
+                fail_fast=self.__config.fail_fast,
+                print_result=self.__config.print_result,
+                throw_exception=self.__config.throw_exception,
+                persistent=self.__config.persistent,
+                persistent_driver=self.__config.persistent_driver,
+                web_report=self.__config.web_report
+            )
+
+            # Prepare paths and pattern for test discovery
+            base_path = (Path.cwd() / self.__config.base_path).resolve()
+            folder_path = self.__config.folder_path
+            pattern = self.__config.pattern
+
+            # Set to hold discovered folders
+            discovered_folders = set()
+
+            # Discover folders containing test files according to the configuration
+
+            # Search all folders under base_path
+            if folder_path == '*':
+                discovered_folders.update(self.__listMatchingFolders(base_path, base_path, pattern))
 
-        # Configure the unit test with parameters from the configuration
-        self.__unit_test.configure(
-            verbosity=self.__config.verbosity,
-            execution_mode=self.__config.execution_mode,
-            max_workers=self.__config.max_workers,
-            fail_fast=self.__config.fail_fast,
-            print_result=self.__config.print_result,
-            throw_exception=self.__config.throw_exception,
-            persistent=self.__config.persistent,
-            persistent_driver=self.__config.persistent_driver,
-            web_report=self.__config.web_report
-        )
-
-        # Prepare paths and pattern for test discovery
-        base_path = (Path.cwd() / self.__config.base_path).resolve()
-        folder_path = self.__config.folder_path
-        pattern = self.__config.pattern
-
-        # Set to hold discovered folders
-        discovered_folders = set()
-
-        # Discover folders containing test files according to the configuration
-
-        # Search all folders under base_path
-        if folder_path == '*':
-            discovered_folders.update(self.__listMatchingFolders(base_path, base_path, pattern))
-
-        # Search each custom folder in the list
-        elif isinstance(folder_path, list):
-            for custom in folder_path:
-                custom_path = (base_path / custom).resolve()
+            # Search each custom folder in the list
+            elif isinstance(folder_path, list):
+                for custom in folder_path:
+                    custom_path = (base_path / custom).resolve()
+                    discovered_folders.update(self.__listMatchingFolders(base_path, custom_path, pattern))
+
+            # Search a single custom folder
+            else:
+                custom_path = (base_path / folder_path).resolve()
                 discovered_folders.update(self.__listMatchingFolders(base_path, custom_path, pattern))
 
-        # Search a single custom folder
-        else:
-            custom_path = (base_path / folder_path).resolve()
-            discovered_folders.update(self.__listMatchingFolders(base_path, custom_path, pattern))
-
-        # Register discovered folders with the unit test for test discovery
-        for folder in discovered_folders:
-            self.__unit_test.discoverTestsInFolder(
-                folder_path=folder,
-                base_path=self.__config.base_path,
-                pattern=pattern,
-                test_name_pattern=self.__config.test_name_pattern or None,
-                tags=self.__config.tags or None
-            )
+            # Register discovered folders with the unit test for test discovery
+            for folder in discovered_folders:
+                self.__unit_test.discoverTestsInFolder(
+                    folder_path=folder,
+                    base_path=self.__config.base_path,
+                    pattern=pattern,
+                    test_name_pattern=self.__config.test_name_pattern or None,
+                    tags=self.__config.tags or None
+                )
+
+            # Run the unit tests and return the result
+            return self.__unit_test.run()
+
+        except OrionisTestFailureException as e:
+
+            # Handle test failures and exit with an error message
+            self.__console.exitError(f"Test execution failed: {e}")
+
+        except Exception as e:
 
-        # Run the unit tests and return the result
-        return self.__unit_test.run()
+            # Handle unexpected errors and exit with a generic error message
+            self.__console.exitError(f"An unexpected error occurred: {e}")

{orionis-0.427.0.dist-info → orionis-0.428.0.dist-info}/METADATA

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

{orionis-0.427.0.dist-info → orionis-0.428.0.dist-info}/RECORD

@@ -3,8 +3,6 @@ orionis/_console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,
 orionis/_console/command_filter.py,sha256=bn0fcWfQg13DrQBaV4NopNxdP-6up0G54Qmhg7r_BKA,1211
 orionis/_console/kernel.py,sha256=M4Zc9x-1hrQP7Dq6Ons5UnGoq73XV1Fwa9cwY7zqWbw,883
 orionis/_console/parser.py,sha256=s-e7I4vr2rwg2g8eesvrOnp1jcEiLlBJN4wLh3JyKUE,5578
-orionis/_console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_console/base/command.py,sha256=J1BluZaVOeWwwm7NkvFcQqPjzZe_aYXW3icUJA38mZU,12320
 orionis/_console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_console/commands/cache_clear.py,sha256=TNrAyB84QZQv_etn7srt_TPE9j6fLNkqymC-1jZ9XEI,2892
 orionis/_console/commands/help.py,sha256=KWHemD2j8YZdX-J6GYL3CNcoByb3XAgxGFzZRZsTKrk,2538
@@ -12,20 +10,18 @@ orionis/_console/commands/schedule_work.py,sha256=IcraCM_jvEXGyQpMUz6qWA2uW4ILhE
 orionis/_console/commands/version.py,sha256=r7I782jVS_1kbxAVfViGGj1m4GoDJtrb_V_L4MKYGfU,1051
 orionis/_console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_console/dumper/dump_die.py,sha256=AsKrcuPwVgTT3UA8DxqFCzuZsGkaGm7bwkm-pr9XlaE,17089
-orionis/_console/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/_console/exceptions/cli-orionis-value-error.py,sha256=RQP0HRwxDG8hxFOT1kUoZ1Ab1CZ1KLoSIl5yqlmgG4M,1147
-orionis/_console/exceptions/cli_exception.py,sha256=HsZ_vSeNiJWQ0gznVFNcIdhM0Bj_vkSRVBJs0wMjEKY,1141
-orionis/_console/exceptions/cli_runtime_error.py,sha256=DaCDGu6mXBk1LIzc7cwRROw1mePAigPNASjNZHhUSBE,1154
-orionis/_console/exceptions/cli_schedule_exception.py,sha256=IBbXb_5zi02pyo1laHdjGn6FYZK7WWRp4j2fkZOCT6I,1161
 orionis/_console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/_console/output/console.py,sha256=6KlvtE4ys6jJU9yLjAVYIHWDmHfWcOHIn_QGcHiJgq0,18894
 orionis/_console/output/executor.py,sha256=sk1l_SmTDE9ZDCUQ95XCwfx7HfBNJFOVs7Kjez9wBSc,3358
 orionis/_console/output/progress_bar.py,sha256=EX1d_sw9JRlE2gWu24bBBRpP2mWfgO_P9S6ztvWuZ2Q,3088
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/console/kelnel.py,sha256=1CuBCLR6KItRt0_m50YQXirJUMX6lJf4Z4vvOjBqaUU,856
 orionis/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/base/command.py,sha256=2kKyTaEzI16Up-XCUeNeJmDWPLN-CweQm3EgrN9U8NQ,3027
 orionis/console/base/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/base/contracts/command.py,sha256=s9yjma-s1URkVm0EbVvSkETAm-N8xX7OnZS43P8pvk8,1957
+orionis/console/commands/version.py,sha256=6usAWQnhmpCY5S95gRm1xVQc0ph-qd7UwMI_5OaDKmQ,1031
+orionis/console/contracts/kernel.py,sha256=fzD8FNVSKEQ5gW5D83hVecz9dVHgy28rRDORDdghp4s,409
 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
@@ -34,6 +30,11 @@ orionis/console/dynamic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG
 orionis/console/dynamic/progress_bar.py,sha256=Cw6YqTVhD39TOZe7Ofz1qcDswHm_UVbs-wyS4jOMNzs,3126
 orionis/console/dynamic/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dynamic/contracts/progress_bar.py,sha256=NYebL2h-vg2t2H6IhJjuC37gglRkpT-MW71wbJtpLNg,1784
+orionis/console/exceptions/__init__.py,sha256=0qlHNuHMVZO87M-rP8lThUUyljRM1jSFNikaxSCjSbw,366
+orionis/console/exceptions/cli_exception.py,sha256=HsZ_vSeNiJWQ0gznVFNcIdhM0Bj_vkSRVBJs0wMjEKY,1141
+orionis/console/exceptions/cli_orionis_value_error.py,sha256=RQP0HRwxDG8hxFOT1kUoZ1Ab1CZ1KLoSIl5yqlmgG4M,1147
+orionis/console/exceptions/cli_runtime_error.py,sha256=DaCDGu6mXBk1LIzc7cwRROw1mePAigPNASjNZHhUSBE,1154
+orionis/console/exceptions/cli_schedule_exception.py,sha256=IBbXb_5zi02pyo1laHdjGn6FYZK7WWRp4j2fkZOCT6I,1161
 orionis/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/output/console.py,sha256=cN0Jq0KEJaOfM5Y9La3Eel1o6nkVqx_TCWcQ-xyarFw,18725
 orionis/console/output/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -75,7 +76,7 @@ orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYq
 orionis/container/validators/is_valid_alias.py,sha256=4uAYcq8xov7jZbXnpKpjNkxcZtlTNnL5RRctVPMwJes,1424
 orionis/container/validators/lifetime.py,sha256=IQ43fDNrxYHMlZH2zlYDJnlkLO_eS4U7Fs3UJgQBidI,1844
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=FVQqZgv3_lMvpPZ6vYk24MknUtd2VIXwAcxSzdn09t4,49494
+orionis/foundation/application.py,sha256=0dzMnxCJkFDU3dQWHcGu8V6Vl6GTgJbcAj3KU-bZqFY,49595
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=vbzduprRCNyYeR2nnMaqc1uKXw6PTzAY2jVfXNQKN8I,9691
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -185,7 +186,7 @@ orionis/foundation/providers/progress_bar_provider.py,sha256=WW3grNgH-yV2meSSTeO
 orionis/foundation/providers/testing_provider.py,sha256=iJSN2RIChbYIL-1ue6vmPmDMCSrvERDkti4Er9MPiLA,1102
 orionis/foundation/providers/workers_provider.py,sha256=kiQjQRyUEyiBX2zcbF_KmqRgvc7Bvxsvg5oMtIvYniM,1075
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=2KxhlB8r7AO29c8aZHEQvsU7tqRPvUHrrD0lueqzjWg,4960
+orionis/metadata/framework.py,sha256=hQtH6dmV2_XxGLqwzTefzmVqoGk-BXn8vio170CjW9Q,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -306,7 +307,7 @@ orionis/support/standard/exceptions/value.py,sha256=7xry_TZz3k-BLAZTR_uDiQ0RfXOk
 orionis/support/wrapper/__init__.py,sha256=jGoWoIGYuRYqMYQKlrX7Dpcbg-AGkHoB_aM2xhu73yc,62
 orionis/support/wrapper/dot_dict.py,sha256=L4J_3id0EHXyjv5FCofXK0ONC2WOoAXZSwX1csitf5E,9299
 orionis/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/kernel.py,sha256=i1VlWl4ZqfGxpc1-JiV3RS0rTrfOMqZJAde1GADK00c,5500
+orionis/test/kernel.py,sha256=ClBrsS0D9jRjlrE3Wqs1plODVlw2GrEN8rodEmTdiqE,6270
 orionis/test/cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/cases/asynchronous.py,sha256=PLdeU4-oked-wU4Z8e588RE09aip2MnkNpLkLpR1J_Q,4304
 orionis/test/cases/synchronous.py,sha256=qAGxxYD9OR9hk54uzOBtZGlkhk7F5XN5-sQ22HIInjU,3526
@@ -353,7 +354,7 @@ orionis/test/validators/web_report.py,sha256=-h3Fe9jY93_kzUhd2NBIqEfCcBpu-8Ei9x3
 orionis/test/validators/workers.py,sha256=LGffDKtK6SKixFKzIYPQpI5aFeQPAGXpv_LUtmEu6g4,1102
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=3ICz68l-WF3BtnYqH5m-ktN9UD00MELMbmMnyJDV74A,4768
-orionis-0.427.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.428.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/test_container.py,sha256=asv8TkkupVoex6SWod74NBl4dSs7wb9mLmu_glNdNy8,14815
@@ -498,8 +499,8 @@ tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 tests/testing/validators/test_testing_validators.py,sha256=QdcF0Vhnnl_kD-PzceHJbUYOqwPTB1Td7YaTv8LTr30,19612
 tests/testing/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/view/test_render.py,sha256=-ghGG8rimyb2b2wtvMuSPPH7Zac5_NlVCiUcHRA5SNg,1172
-orionis-0.427.0.dist-info/METADATA,sha256=CH-YpDiN7kxfyiyqdCKofD7IDFgQZaklGeeIbrMbJSw,4772
-orionis-0.427.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.427.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.427.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.427.0.dist-info/RECORD,,
+orionis-0.428.0.dist-info/METADATA,sha256=4OYvok4BsiU9G8T-GxmzYGDJiuQUyc7w9e72KPAGJts,4772
+orionis-0.428.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.428.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.428.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.428.0.dist-info/RECORD,,

orionis/_console/base/command.py

@@ -1,436 +0,0 @@
-import argparse
-from orionis._console.output.console import Console
-from orionis._console.output.progress_bar import ProgressBar
-from orionis._contracts.console.base.command import IBaseCommand
-
-class BaseCommand(IBaseCommand):
-    """
-    A base class for handling common console output functionalities. This class provides methods to print messages of
-    various types (success, info, warning, etc.) in different styles (e.g., text, bold, colored).
-
-    This class acts as a foundation for command classes, offering utility methods to interact with the console.
-
-    Parameters
-    ----------
-    args : dict, optional
-        A dictionary containing the command arguments (default is an empty dictionary).
-    """
-    args = {}
-
-    def success(self, message: str, timestamp: bool = True) -> None:
-        """
-        Prints a success message with a green background.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        timestamp : bool, optional
-            Whether to include a timestamp (default is True).
-        """
-        Console.success(message, timestamp)
-
-    def textSuccess(self, message: str) -> None:
-        """
-        Prints a success message in green.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textSuccess(message)
-
-    def textSuccessBold(self, message: str) -> None:
-        """
-        Prints a bold success message in green.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textSuccessBold(message)
-
-    def info(self, message: str, timestamp: bool = True) -> None:
-        """
-        Prints an informational message with a blue background.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        timestamp : bool, optional
-            Whether to include a timestamp (default is True).
-        """
-        Console.info(message, timestamp)
-
-    def textInfo(self, message: str) -> None:
-        """
-        Prints an informational message in blue.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textInfo(message)
-
-    def textInfoBold(self, message: str) -> None:
-        """
-        Prints a bold informational message in blue.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textInfoBold(message)
-
-    def warning(self, message: str, timestamp: bool = True):
-        """
-        Prints a warning message with a yellow background.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        timestamp : bool, optional
-            Whether to include a timestamp (default is True).
-        """
-        Console.warning(message, timestamp)
-
-    def textWarning(self, message: str) -> None:
-        """
-        Prints a warning message in yellow.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textWarning(message)
-
-    def textWarningBold(self, message: str) -> None:
-        """
-        Prints a bold warning message in yellow.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textWarningBold(message)
-
-    def fail(self, message: str, timestamp: bool = True) -> None:
-        """
-        Prints a failure message with a red background.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        timestamp : bool, optional
-            Whether to include a timestamp (default is True).
-        """
-        Console.fail(message, timestamp)
-
-    def error(self, message: str, timestamp: bool = True) -> None:
-        """
-        Prints an error message with a red background.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        timestamp : bool, optional
-            Whether to include a timestamp (default is True).
-        """
-        Console.error(message, timestamp)
-
-    def textError(self, message: str) -> None:
-        """
-        Prints an error message in red.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textError(message)
-
-    def textErrorBold(self, message: str) -> None:
-        """
-        Prints a bold error message in red.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textErrorBold(message)
-
-    def textMuted(self, message: str) -> None:
-        """
-        Prints a muted (gray) message.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textMuted(message)
-
-    def textMutedBold(self, message: str) -> None:
-        """
-        Prints a bold muted (gray) message.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textMutedBold(message)
-
-    def textUnderline(self, message: str) -> None:
-        """
-        Prints an underlined message.
-
-        Parameters
-        ----------
-        message : str
-            The message to display.
-        """
-        Console.textUnderline(message)
-
-    def clear(self) -> None:
-        """
-        Clears the console screen.
-        """
-        Console.clear()
-
-    def clearLine(self) -> None:
-        """
-        Clears the current console line.
-        """
-        Console.clearLine()
-
-    def line(self) -> None:
-        """
-        Prints a line empty.
-        """
-        Console.line()
-
-    def newLine(self, count: int = 1) -> None:
-        """
-        Prints multiple new lines.
-
-        Parameters
-        ----------
-        count : int, optional
-            The number of new lines to print (default is 1).
-        """
-        Console.newLine(count)
-
-    def write(self, message: str) -> None:
-        """
-        Prints a message without moving to the next line.
-
-        Parameters
-        ----------
-        message : str, optional
-            The message to display.
-        """
-        Console.write(message)
-
-    def writeLine(self, message: str) -> None:
-        """
-        Prints a message and moves to the next line.
-
-        Parameters
-        ----------
-        message : str, optional
-            The message to display (default is an empty string).
-        """
-        Console.writeLine(message)
-
-    def ask(self, question: str) -> str:
-        """
-        Prompts the user for input and returns the response.
-
-        Parameters
-        ----------
-        question : str
-            The question to ask the user.
-
-        Returns
-        -------
-        str
-            The user's input.
-        """
-        return Console.ask(question).strip()
-
-    def confirm(self, question: str, default: bool = False) -> bool:
-        """
-        Asks a confirmation question and returns True/False based on the user's response.
-
-        Parameters
-        ----------
-        question : str
-            The confirmation question to ask.
-        default : bool, optional
-            The default response if the user presses Enter without typing a response (default is False).
-
-        Returns
-        -------
-        bool
-            The user's response.
-        """
-        return Console.confirm(question, default)
-
-    def secret(self, question: str) -> str:
-        """
-        Prompts for hidden input (e.g., password).
-
-        Parameters
-        ----------
-        question : str
-            The prompt to ask the user.
-
-        Returns
-        -------
-        str
-            The user's hidden input.
-        """
-        return Console.secret(question)
-
-    def table(self, headers: list, rows: list):
-        """
-        Prints a formatted table in the console.
-
-        Parameters
-        ----------
-        headers : list of str
-            The column headers for the table.
-        rows : list of list of str
-            The rows of the table.
-
-        Raises
-        ------
-        ValueError
-            If headers or rows are empty.
-        """
-        Console.table(headers, rows)
-
-    def anticipate(self, question: str, options: list, default=None):
-        """
-        Provides autocomplete suggestions for user input.
-
-        Parameters
-        ----------
-        question : str
-            The prompt for the user.
-        options : list of str
-            The list of possible options for autocomplete.
-        default : str, optional
-            The default value if no matching option is found (default is None).
-
-        Returns
-        -------
-        str
-            The chosen option or the default value.
-        """
-        Console.anticipate(question, options, default)
-
-    def choice(self, question: str, choices: list, default_index: int = 0) -> str:
-        """
-        Prompts the user to select a choice from a list.
-
-        Parameters
-        ----------
-        question : str
-            The prompt for the user.
-        choices : list of str
-            The list of available choices.
-        default_index : int, optional
-            The index of the default choice (default is 0).
-
-        Returns
-        -------
-        str
-            The selected choice.
-
-        Raises
-        ------
-        ValueError
-            If `default_index` is out of the range of choices.
-        """
-        Console.choice(question, choices, default_index)
-
-    def createProgressBar(self, total: int = 100, width: int = 50) -> ProgressBar:
-        """
-        Creates and returns a new progress bar.
-
-        This method initializes a `ProgressBar` object with the specified total and width.
-
-        Parameters
-        ----------
-        total : int, optional
-            The total number of steps for the progress bar. Default is 100.
-        width : int, optional
-            The width (in characters) of the progress bar. Default is 50.
-
-        Returns
-        -------
-        ProgressBar
-            A new instance of the `ProgressBar` class, initialized with the specified `total` and `width`.
-
-        Notes
-        -----
-        The progress bar can be used to visually track the progress of a task.
-        The `total` parameter represents the number of steps to complete the task,
-        and the `width` parameter controls the number of characters used to represent the progress bar in the console.
-        """
-        return ProgressBar(total=total, width=width)
-
-    def handle(self, **kwargs):
-        """
-        Abstract method to define the logic of the command.
-
-        This method must be overridden in subclasses.
-
-        Arguments:
-            **kwargs: Arbitrary keyword arguments.
-
-        Raises:
-            NotImplementedError: If the method is not implemented in a subclass. This ensures that all command classes
-                                adhere to the expected structure.
-        """
-        raise NotImplementedError("The 'handle' method must be implemented in the child class.")
-
-    def setArgs(self, args) -> None:
-        """
-        Define the logic of setting command arguments.
-
-        Parameters
-        ----------
-        args : argparse.Namespace or dict
-            Contain the arguments to be set for the command.
-        """
-        if isinstance(args, argparse.Namespace):
-            self.args = vars(args)
-        elif isinstance(args, dict):
-            self.args = args
-        else:
-            raise ValueError("Invalid argument type. Expected 'argparse.Namespace' or 'dict'.")
-
-    def getArgs(self) -> dict:
-        """
-        Get the command arguments.
-
-        Returns
-        -------
-        dict
-            The command arguments.
-        """
-        return self.args