orionis 0.670.0__py3-none-any.whl → 0.672.0__py3-none-any.whl

orionis/console/core/reactor.py

@@ -565,51 +565,58 @@ class Reactor(IReactor):
             If the 'options' method does not return a list or contains non-CLIArgument instances.
         """
 
-        # Instantiate the command and retrieve its options
-        instance = self.__app.make(obj)
-        options: List[CLIArgument]  = self.__app.call(instance, 'options')
-
-        # Validate that options is a list
-        if not isinstance(options, list):
-            raise CLIOrionisTypeError(
-                f"Command class {obj.__name__} 'options' must return a list."
-            )
+        try:
 
-        # Return None if there are no arguments
-        if not options:
-            return None
+            # Instantiate the command and retrieve its options
+            instance = self.__app.make(obj)
+            options: List[CLIArgument]  = self.__app.call(instance, 'options')
 
-        # Validate all items are CLIArgument instances
-        for idx, arg in enumerate(options):
-            if not isinstance(arg, CLIArgument):
+            # Validate that options is a list
+            if not isinstance(options, list):
                 raise CLIOrionisTypeError(
-                    f"Command class {obj.__name__} 'options' must contain only CLIArgument instances, "
-                    f"found '{type(arg).__name__}' at index {idx}."
+                    f"Command class {obj.__name__} 'options' must return a list."
                 )
 
+            # Return None if there are no arguments
+            if not options:
+                return None
+
+            # Validate all items are CLIArgument instances
+            for idx, arg in enumerate(options):
+                if not isinstance(arg, CLIArgument):
+                    raise CLIOrionisTypeError(
+                        f"Command class {obj.__name__} 'options' must contain only CLIArgument instances, "
+                        f"found '{type(arg).__name__}' at index {idx}."
+                    )
+
+
+            # Get the Signature attribute from the command class
+            rf_concrete = ReflectionConcrete(obj)
+            signature = rf_concrete.getAttribute('signature', '<unknown>')
+            description = rf_concrete.getAttribute('description', '')
+
+            # Build the ArgumentParser
+            arg_parser = argparse.ArgumentParser(
+                usage=f"python -B reactor {signature} [options]",
+                description=f"Command [{signature}] : {description}",
+                formatter_class=argparse.RawTextHelpFormatter,
+                add_help=True,
+                allow_abbrev=False,
+                exit_on_error=True,
+                prog=signature
+            )
+
+            # Add each CLIArgument to the ArgumentParser
+            for arg in options:
+                arg.addToParser(arg_parser)
 
-        # Get the Signature attribute from the command class
-        rf_concrete = ReflectionConcrete(obj)
-        signature = rf_concrete.getAttribute('signature', '<unknown>')
-        description = rf_concrete.getAttribute('description', '')
-
-        # Build the ArgumentParser
-        arg_parser = argparse.ArgumentParser(
-            usage=f"python -B reactor {signature} [options]",
-            description=f"Command [{signature}] : {description}",
-            formatter_class=argparse.RawTextHelpFormatter,
-            add_help=True,
-            allow_abbrev=False,
-            exit_on_error=True,
-            prog=signature
-        )
+            # Return the constructed ArgumentParser
+            return arg_parser
 
-        # Add each CLIArgument to the ArgumentParser
-        for arg in options:
-            arg.addToParser(arg_parser)
+        except Exception as e:
 
-        # Return the constructed ArgumentParser
-        return arg_parser
+            # Raise a runtime error if any exception occurs during argument processing
+            raise CLIOrionisRuntimeError(e) from e
 
     def __parseArgs(
         self,

orionis/failure/base/handler.py

@@ -14,13 +14,13 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         # Example: OrionisContainerException
     ]
 
-    async def destructureException(self, exception: BaseException) -> Throwable:
+    async def destructureException(self, exception: Exception) -> Throwable:
         """
         Converts an exception into a structured `Throwable` object containing detailed information.
 
         Parameters
         ----------
-        e : BaseException
+        e : Exception
             The exception instance to be destructured.
 
         Returns
@@ -34,14 +34,22 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         and wraps them in a `Throwable` object for consistent error handling and reporting.
         """
 
+        # Safely extract the exception arguments, defaulting to an empty string if none are present
+        args = getattr(exception, 'args', None)
+        if not args:
+            args = ("",)
+
+        # Optionally, ensure all args are stringified for consistency
+        args = tuple(str(arg) for arg in args)
+
         return Throwable(
-            classtype=type(exception),                                          # The class/type of the exception
-            message=exception.args[0] if exception.args else str(exception),    # The exception message as a string
-            args=exception.args,                                                # The arguments passed to the exception
-            traceback=exception.__traceback__ or traceback.format_exc()         # The traceback object, if available
+            classtype=type(exception),                                      # The class/type of the exception
+            message=args[0],                                                # The exception message as a string
+            args=args,                                                      # The arguments passed to the exception
+            traceback=exception.__traceback__ or traceback.format_exc()     # The traceback object, if available
         )
 
-    async def shouldIgnoreException(self, exception: BaseException) -> bool:
+    async def shouldIgnoreException(self, exception: Exception) -> bool:
         """
         Determines if the exception should be ignored (not handled) by the handler.
 
@@ -57,7 +65,7 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         """
 
         # Ensure the provided object is an exception
-        if not isinstance(exception, BaseException):
+        if not isinstance(exception, (BaseException, Exception)):
             raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
 
         # Convert the exception into a structured Throwable object
@@ -66,13 +74,13 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         # Check if the exception type is in the list of exceptions to ignore
         return hasattr(self, 'dont_catch') and throwable.classtype in self.dont_catch
 
-    async def report(self, exception: BaseException, log: ILogger) -> Any:
+    async def report(self, exception: Exception, log: ILogger) -> Any:
         """
         Report or log an exception.
 
         Parameters
         ----------
-        exception : BaseException
+        exception : Exception
             The exception instance that was caught.
 
         Returns
@@ -80,7 +88,7 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         None
         """
         # Ensure the provided object is an exception
-        if not isinstance(exception, BaseException):
+        if not isinstance(exception, (BaseException, Exception)):
             raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
 
         # Convert the exception into a structured Throwable object
@@ -92,13 +100,13 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         # Return the structured exception
         return throwable
 
-    async def renderCLI(self, exception: BaseException, request: ICLIRequest, log: ILogger, console: IConsole) -> Any:
+    async def renderCLI(self, exception: Exception, request: ICLIRequest, log: ILogger, console: IConsole) -> Any:
         """
         Render the exception message for CLI output.
 
         Parameters
         ----------
-        exception : BaseException
+        exception : Exception
             The exception instance that was caught.
 
         Returns
@@ -106,8 +114,8 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         None
         """
         # Ensure the provided object is an exception
-        if not isinstance(exception, BaseException):
-            raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
+        if not isinstance(exception, (BaseException, Exception)):
+            raise TypeError(f"Expected Exception, got {type(exception).__name__}")
 
         # Ensure the request is a CLIRequest
         if not isinstance(request, ICLIRequest):

orionis/failure/catch.py

@@ -41,7 +41,7 @@ class Catch(ICatch):
         # Retrieve the console output service from the application container
         self.__exception_handler: IBaseExceptionHandler = app.getExceptionHandler()
 
-    def exception(self, kernel: Any, request: Any, e: BaseException) -> None:
+    def exception(self, kernel: Any, request: Any, e: BaseException | Exception) -> None:
         """
         Handles and reports exceptions that occur during CLI execution.
 
@@ -69,8 +69,8 @@ class Catch(ICatch):
         """
 
         # If there is no exception handler, return early
-        if self.__app.call(self.__exception_handler, 'shouldIgnoreException', exception=e):
-            return
+        # if self.__app.call(self.__exception_handler, 'shouldIgnoreException', exception=e):
+        #     return
 
         # Report the exception using the exception handler and logger
         self.__app.call(self.__exception_handler, 'report', exception=e)

orionis/failure/contracts/catch.py

@@ -4,7 +4,7 @@ from typing import Any
 class ICatch(ABC):
 
     @abstractmethod
-    def exception(self, kernel: Any, request: Any, e: BaseException) -> None:
+    def exception(self, kernel: Any, request: Any, e: BaseException | Exception) -> None:
         """
         Handles and reports exceptions that occur during CLI execution.
 

orionis/failure/contracts/handler.py

@@ -7,13 +7,13 @@ from orionis.services.log.contracts.log_service import ILogger
 class IBaseExceptionHandler:
 
     @abstractmethod
-    async def destructureException(self, e: BaseException):
+    async def destructureException(self, e: Exception):
         """
         Converts an exception into a structured `Throwable` object containing detailed information.
 
         Parameters
         ----------
-        e : BaseException
+        e : Exception
             The exception instance to be destructured.
 
         Returns
@@ -29,13 +29,13 @@ class IBaseExceptionHandler:
         pass
 
     @abstractmethod
-    async def shouldIgnoreException(self, e: BaseException) -> bool:
+    async def shouldIgnoreException(self, e: Exception) -> bool:
         """
         Determines if the exception should be ignored (not handled) by the handler.
 
         Parameters
         ----------
-        e : BaseException
+        e : Exception
             The exception instance to check.
 
         Returns
@@ -46,13 +46,13 @@ class IBaseExceptionHandler:
         pass
 
     @abstractmethod
-    async def report (self, exception: BaseException, log: ILogger) -> Any:
+    async def report (self, exception: Exception, log: ILogger) -> Any:
         """
         Report or log an exception.
 
         Parameters
         ----------
-        exception : BaseException
+        exception : Exception
             The exception instance that was caught.
 
         Returns
@@ -62,13 +62,13 @@ class IBaseExceptionHandler:
         pass
 
     @abstractmethod
-    async def renderCLI(self, exception: BaseException, request: ICLIRequest, log: ILogger, console: IConsole) -> Any:
+    async def renderCLI(self, exception: Exception, request: ICLIRequest, log: ILogger, console: IConsole) -> Any:
         """
         Render the exception message for CLI output.
 
         Parameters
         ----------
-        exception : BaseException
+        exception : Exception
             The exception instance that was caught.
 
         Returns

orionis/failure/entities/throwable.py

@@ -30,4 +30,5 @@ class Throwable:
 
     classtype: type                     # The type of the throwable (e.g., Exception class)
     message: str                        # The error message associated with the throwable
+    args: tuple                         # Arguments passed to the throwable
     traceback: Optional[str] = None     # Optional traceback information as a string

orionis/metadata/framework.py

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

{orionis-0.670.0.dist-info → orionis-0.672.0.dist-info}/METADATA

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

{orionis-0.670.0.dist-info → orionis-0.672.0.dist-info}/RECORD

@@ -32,7 +32,7 @@ orionis/console/contracts/reactor.py,sha256=iT6ShoCutAWEeJzOf_PK7CGXi9TgrOD5tewH
 orionis/console/contracts/schedule.py,sha256=xtXgp4BPhvhg3YSM4mrIdbyoBdr4OJBi1gBM_kJN5UQ,13694
 orionis/console/contracts/schedule_event_listener.py,sha256=h06qsBxuEMD3KLSyu0JXdUDHlQW19BX9lA09Qrh2QXg,3818
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=ZIiov3nKrONu_QjY61tj-vNOO082GBwoA7MTXcmQif0,43946
+orionis/console/core/reactor.py,sha256=qctLns-f5eB9Air7Qi4hvX5KB5A7SsHeV8M5zYJEiPA,44286
 orionis/console/debug/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/debug/dumper.py,sha256=vbmP_GlrzBj0KDjiQl4iDudPRe6V0W5r5UA8i3h9_c4,6555
 orionis/console/dynamic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -84,14 +84,14 @@ orionis/container/facades/facade.py,sha256=c9V4ywJCdux1oluzVc7ph_8-TY2Nc85k3_UeQ
 orionis/container/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/providers/service_provider.py,sha256=OlqmBIkZSDZHJ_JZvwhNiMMrn-GzeIoCgR-HdsqGOVM,2385
 orionis/failure/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/catch.py,sha256=O6C_KsSPI-ZZb8upzwGagkJMhQ6FWX7J2q9BWweMgQE,3286
+orionis/failure/catch.py,sha256=EMRWQ3liYnQoyhCCvPu7nzfnWmJwKIKsPtMiGWP107o,3302
 orionis/failure/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/base/handler.py,sha256=G-SygxqdEQmlV1Bpx78n9fY3HbobZlc0l30up7U29vA,4824
+orionis/failure/base/handler.py,sha256=5B6IxbGDWol7cZu7-TOrO2SXb58ozTeg1GHk6FAFkP0,5136
 orionis/failure/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/contracts/catch.py,sha256=me7o9QIliD6A62f1nTGjPapbULjhC1ZRh136s1HpF24,1193
-orionis/failure/contracts/handler.py,sha256=AeJfkJfD3hTkOIYAtADq6GnQfq-qWgDfUc7bYMdYKAU,2240
+orionis/failure/contracts/catch.py,sha256=HCMcz08A2F_A8GoTpI4p3u7-ZqnyJXaJhP1fcFIY52w,1205
+orionis/failure/contracts/handler.py,sha256=6HWe9aQKTnGHaGb8ttsaQTJO1vSiXhZDkIDvb9-sWWU,2208
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/entities/throwable.py,sha256=FOMR5y9ARo4xAxxPa7ZlKVf4lS8eP56LmoASZFCyblU,1236
+orionis/failure/entities/throwable.py,sha256=m1DroY-SaxrJsQ8PW496lvMRIWDU8vaveGNI7CGzQGU,1313
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/application.py,sha256=33Z6-0iT7pbZw74zHRV_z_6CLUO-huIfkd236zl0wP4,93824
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -206,7 +206,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=IrPQJwvQVLRm5Qnz0Cxon4
 orionis/foundation/providers/testing_provider.py,sha256=eI1p2lUlxl25b5Z487O4nmqLE31CTDb4c3Q21xFadkE,1615
 orionis/foundation/providers/workers_provider.py,sha256=GdHENYV_yGyqmHJHn0DCyWmWId5xWjD48e6Zq2PGCWY,1674
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=LesLKbjk7T98qJUuqa1Cm0Km48H0gVB6ri92ytCHpUw,4089
+orionis/metadata/framework.py,sha256=eMXy0dxPBfl1IqUyX23hng2Vfk04cmMg_2HHsZLCr5M,4089
 orionis/metadata/package.py,sha256=s1JeGJPwdVh4jO3IOfmpwMuJ_oX6Vf9NL7jgPEQNf5Y,16050
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -393,8 +393,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=arysoswhkV2vUd2aVMZRPpmH317jaWbgjDpQ_AWQ5AE,5663
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.670.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.670.0.dist-info/METADATA,sha256=U-y1eKzRJUoSRQPM7ycqne6DXrqMIFy9Fm5V6u1yS78,4772
-orionis-0.670.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.670.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.670.0.dist-info/RECORD,,
+orionis-0.672.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.672.0.dist-info/METADATA,sha256=pzALGHPw_H9_MsP7awPsyS8yrki6VRqbJHt5QjnuTwU,4772
+orionis-0.672.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.672.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.672.0.dist-info/RECORD,,