orionis 0.504.0__py3-none-any.whl → 0.505.0__py3-none-any.whl

orionis/console/core/reactor.py

@@ -400,10 +400,13 @@ class Reactor(IReactor):
 
         # Create an ArgumentParser instance to handle the command arguments
         arg_parser = argparse.ArgumentParser(
-            description=f"{obj.signature} - {obj.description}",
-            formatter_class=argparse.RawDescriptionHelpFormatter,
+            usage=f"python -B reactor {obj.signature} [options]",
+            description=f"Command [{obj.signature}] : {obj.description}",
+            formatter_class=argparse.RawTextHelpFormatter,
             add_help=True,
-            allow_abbrev=False
+            allow_abbrev=False,
+            exit_on_error=True,
+            prog=obj.signature
         )
         for arg in required_args:
             arg.addToParser(arg_parser)

orionis/console/entities/request.py

@@ -27,9 +27,11 @@ class CLIRequest(BaseEntity):
     """
 
     # The command to execute
-    command: str
+    command: str = field(
+        default=None
+    )
 
     # Arguments for the command; defaults to an empty list if not provided
     args: list[str] = field(
-        default_factory=list
+        default_factory=lambda: []
     )

orionis/console/kernel.py

@@ -1,8 +1,8 @@
-import sys
 from typing import List
 from orionis.console.contracts.kernel import IKernelCLI
 from orionis.console.contracts.reactor import IReactor
 from orionis.console.entities.request import CLIRequest
+from orionis.console.request.cli_request import Request
 from orionis.failure.contracts.catch import ICatch
 from orionis.foundation.contracts.application import IApplication
 from orionis.console.exceptions import CLIOrionisValueError
@@ -65,42 +65,20 @@ class KernelCLI(IKernelCLI):
             If invalid arguments are provided or no command is specified, this method may terminate the process with an error message.
         """
 
-        try:
-
-            # Ensure the arguments are provided as a list
-            if not isinstance(args, list):
-                raise CLIOrionisValueError(
-                    f"Failed to handle command line arguments: expected list, got {type(args).__module__}.{type(args).__name__}."
-                )
-
-            # If no arguments or only the script name is provided, show the default help command
-            if not args or len(args) <= 1:
-                return self.__reactor.call('help')
-
-            # Remove the first argument (script name) to process only the command and its parameters
-            args = args[1:]
+        request: CLIRequest = CLIRequest()
 
-            # If no command is provided after removing the script name, exit with an error
-            if len(args) == 0:
-                raise CLIOrionisValueError("No command provided to execute.")
-
-            # If only the command is provided, call it without additional arguments
-            if len(args) == 1:
-                return self.__reactor.call(args[0])
+        try:
 
-            # Create a CLIRequest instance with the command and its arguments
-            command = CLIRequest(
-                command=args[0],
-                args=args[1:]
-            )
+            # create a CLIRequest instance by processing the provided arguments
+            request = Request(args)
 
             # If command and arguments are provided, call the command with its arguments
             return self.__reactor.call(
-                command.command,
-                command.args
+                request.command,
+                request.args
             )
 
         except BaseException as e:
 
             # Catch any exceptions that occur during command handling
-            self.__catch.exception(self, args, e)
+            self.__catch.exception(self, request, e)

orionis/console/request/cli_request.py

@@ -0,0 +1,45 @@
+from typing import List
+from orionis.console.entities.request import CLIRequest as CLIRequestEntity
+from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
+
+class CLIRequest:
+    def __call__(self, args: List[str]) -> "CLIRequestEntity":
+        """
+        Processes command-line arguments and returns a CLIRequest instance.
+
+        Parameters
+        ----------
+        args : List[str]
+            The list of command-line arguments. The first argument is expected to be the script name.
+
+        Returns
+        -------
+        CLIRequestEntity
+            An instance representing the parsed command and its arguments.
+
+        Raises
+        ------
+        CLIOrionisValueError
+            If the provided arguments are not a list or if no command is provided.
+        """
+        if not isinstance(args, list):
+            raise CLIOrionisValueError(
+                f"Failed to handle command line arguments: expected list, got {type(args).__module__}.{type(args).__name__}."
+            )
+
+        if len(args) <= 1:
+            raise CLIOrionisValueError("No command provided to execute.")
+
+        # Remove the script name
+        args = args[1:]
+
+        if not args or not args[0]:
+            raise CLIOrionisValueError("No command provided to execute.")
+
+        return CLIRequestEntity(
+            command=args[0],
+            args=args[1:]
+        )
+
+# Export the CLIRequest Singleton
+Request = CLIRequest()

orionis/failure/base/handler.py

@@ -1,4 +1,5 @@
 from typing import Any, List
+from orionis.console.entities.request import CLIRequest
 from orionis.console.output.contracts.console import IConsole
 from orionis.failure.contracts.handler import IBaseExceptionHandler
 from orionis.failure.entities.throwable import Throwable
@@ -91,7 +92,7 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         # Return the structured exception
         return throwable
 
-    def renderCLI(self, args: List[str], exception: BaseException, log: ILogger, console: IConsole) -> Any:
+    def renderCLI(self, request: CLIRequest, exception: BaseException, log: ILogger, console: IConsole) -> Any:
         """
         Render the exception message for CLI output.
 
@@ -111,8 +112,11 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         # Convert the exception into a structured Throwable object
         throwable = self.destructureException(exception)
 
+        args = request.args if isinstance(request, CLIRequest) and request.args else []
+        string_args = ' '.join(args)
+
         # Log the CLI error message with arguments
-        log.error(f"CLI Error: {throwable.message} (Args: {args})")
+        log.error(f"CLI Error: {throwable.message} (Args: {string_args})")
 
         # Output the exception traceback to the console
         console.newLine()

orionis/failure/catch.py

@@ -86,7 +86,7 @@ class Catch(ICatch):
         # If a kernel is provided, render the exception details to the CLI
         if isinstance(kernel, KernelCLI):
             return self.__exception_handler.renderCLI(
-                args=request,
+                request=request,
                 exception=e,
                 log=self.__logger,
                 console=self.__console

orionis/failure/contracts/handler.py

@@ -1,5 +1,6 @@
 from abc import abstractmethod
-from typing import Any, List
+from typing import Any
+from orionis.console.entities.request import CLIRequest
 from orionis.console.output.contracts.console import IConsole
 from orionis.services.log.contracts.log_service import ILogger
 
@@ -61,7 +62,7 @@ class IBaseExceptionHandler:
         pass
 
     @abstractmethod
-    def renderCLI(self, args: List[str], exception: BaseException, log: ILogger, console: IConsole) -> Any:
+    def renderCLI(self, request: CLIRequest, exception: BaseException, log: ILogger, console: IConsole) -> Any:
         """
         Render the exception message for CLI output.
 

orionis/metadata/framework.py

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

{orionis-0.504.0.dist-info → orionis-0.505.0.dist-info}/METADATA

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

{orionis-0.504.0.dist-info → orionis-0.505.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=KPFKnz5zkWytB0-UNdsV9t_1m2tyA6TLc4mDA2q8v5o,4042
+orionis/console/kernel.py,sha256=m4RoulZB3nkl6-O250UDN4ZoXqfTF4F5gbAYt7TAnQo,3054
 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
@@ -28,7 +28,7 @@ orionis/console/contracts/listener.py,sha256=tXp2kTVEaqLRWZC6BY8xqj3JP0xpDDx4btP
 orionis/console/contracts/reactor.py,sha256=Xeq7Zrw6WE5MV_XOQfiQEchAFbb6-0TjLpjWOxYW--g,4554
 orionis/console/contracts/schedule.py,sha256=eGjcOH7kgdf0fWDZRfOFUQsIx4E8G38ayX5JwpkpN8E,4977
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=FMf64avmcuC1JtdjC8LLrgPuhp_Nau9Q_LcLl6JJ6DM,30278
+orionis/console/core/reactor.py,sha256=3i7-jn_HBwYfsNR8xpExt5Owi3nk9BfHnW7J7lUmb-4,30414
 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
@@ -39,7 +39,7 @@ orionis/console/dynamic/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeR
 orionis/console/dynamic/contracts/progress_bar.py,sha256=NYebL2h-vg2t2H6IhJjuC37gglRkpT-MW71wbJtpLNg,1784
 orionis/console/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/entities/listeners.py,sha256=I5JbbnwKz-ZQhQgS2r1wqfUTwagg8Os6qzfEY8FzVzg,5345
-orionis/console/entities/request.py,sha256=5FikL80Ks99Ut4AlfKpyXIKVMZQUtYqvfCFn80lPZdc,936
+orionis/console/entities/request.py,sha256=Sm-6jMd95teUEdh_4VJWjsDbvfID3khHCOU_2OEEIv4,980
 orionis/console/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/enums/command.py,sha256=lCfVp2vnDojJN2gjdVxE_XU3mRjZZgOIxPfBVQYo9w4,1278
 orionis/console/enums/event.py,sha256=XRV7N14N5HHt-c0HqYhrbKv4n2P7ZOCcBT_3OAQzenU,1929
@@ -56,6 +56,7 @@ orionis/console/output/contracts/console.py,sha256=phaQhCLWa81MLzB5ydOSaUfEIdDq7
 orionis/console/output/contracts/executor.py,sha256=7l3kwnvv6GlH9EYk0v94YE1olex_-mvgyRDAqZvvYrQ,4254
 orionis/console/output/enums/__init__.py,sha256=LAaAxg-DpArCjf_jqZ0_9s3p8899gntDYkSU_ppTdC8,66
 orionis/console/output/enums/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
+orionis/console/request/cli_request.py,sha256=7-sgYmNUCipuHLVAwWLJiHv0cJCDmsM1Lu9s2D8RIII,1498
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/tasks/event.py,sha256=NcSmq3y4JWviXaSvRifmJs0nWqQQgHIDmzlWELrLeNU,12204
 orionis/console/tasks/exception_report.py,sha256=IN1PCQ08ZHs1sivUpzi2f9U9eW8ydZyb8GO6KiT56LY,3643
@@ -93,12 +94,12 @@ 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/failure/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/catch.py,sha256=LCr2Fy7mMwhAILx9VVb0KUZTRPg7UyE_8Ai_hJP0NMQ,3627
+orionis/failure/catch.py,sha256=qob2sM-VmYo5C6rY21UdBEAIpJo0bwpjRW1hQjbrOnI,3630
 orionis/failure/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/base/handler.py,sha256=vA4u9UqKzzRXIafLTxi3beeCxPGco_0BMhazASahNqs,4464
+orionis/failure/base/handler.py,sha256=L6jB2_2f8ZKBuys8o_iXTwMM_yjQHY7iXNF1Q3X8BGY,4661
 orionis/failure/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/contracts/catch.py,sha256=e2wM1p6VxbvAjgWm-MwoM9p2ystSsyBu8Qnt6Ehr6Vc,1179
-orionis/failure/contracts/handler.py,sha256=1WyFx7D9h5chNnOXDQhg6o-RqNfhTHblm_xWzCDu4SM,2161
+orionis/failure/contracts/handler.py,sha256=4N9yMkMgdhtHbRGAyCtuTx3GmkPP74vhqdRLmwl-ckQ,2216
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/entities/throwable.py,sha256=ogys062uhim5QMYU62ezlnumRAnYQlUf_vZvQY47S3U,1227
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -218,7 +219,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=72SoixFog9IOE9Ve9Xcfw6
 orionis/foundation/providers/testing_provider.py,sha256=SrJRpdvcblx9WvX7x9Y3zc7OQfiTf7la0HAJrm2ESlE,3725
 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=AYMbt2P-GM7ooLNwbP6C8foJqalDU8Fe9MK2UqIr8PA,4109
+orionis/metadata/framework.py,sha256=kzHxiSxC1o-lxs1vOuDC4drt88JpIaCgTGUcNrNqiPs,4109
 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
@@ -394,8 +395,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.504.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis-0.505.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/test_manager.py,sha256=wOwXpl9rHNfTTexa9GBKYMwK0_-KSQPbI-AEyGNkmAE,1356
@@ -541,8 +541,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.504.0.dist-info/METADATA,sha256=ZM434O0Rv0eXh9QC4jQvPXabW2jM6BwmZmOGUrgSJE0,4801
-orionis-0.504.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.504.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.504.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.504.0.dist-info/RECORD,,
+orionis-0.505.0.dist-info/METADATA,sha256=MqayyZx1WKcTz0VN1_shUY09IPXfVWT5juaChVqNY3o,4801
+orionis-0.505.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.505.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.505.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.505.0.dist-info/RECORD,,