orionis 0.493.0__py3-none-any.whl → 0.494.0__py3-none-any.whl

orionis/failure/base/handler.py

@@ -40,6 +40,31 @@ class BaseExceptionHandler(IBaseExceptionHandler):
             traceback=getattr(e, '__traceback__', None)     # The traceback object, if available
         )
 
+    def shouldIgnoreException(self, e: BaseException) -> bool:
+        """
+        Determines if the exception should be ignored (not handled) by the handler.
+
+        Parameters
+        ----------
+        e : BaseException
+            The exception instance to check.
+
+        Returns
+        -------
+        bool
+            True if the exception should be ignored, False otherwise.
+        """
+
+        # Ensure the provided object is an exception
+        if not isinstance(e, BaseException):
+            raise TypeError(f"Expected BaseException, got {type(e).__name__}")
+
+        # Convert the exception into a structured Throwable object
+        throwable = self.destructureException(e)
+
+        # Check if the exception type is in the list of exceptions to ignore
+        return hasattr(self, 'dont_cathc') and throwable.classtype in self.dont_cathc
+
     def report (self, exception: BaseException, log: ILogger) -> Any:
         """
         Report or log an exception.

orionis/failure/catch.py

@@ -77,6 +77,10 @@ class Catch(ICatch):
         If a valid kernel is provided, the exception details are rendered to the CLI.
         """
 
+        # Check if the exception should be ignored by the handler
+        if self.__exception_handler.shouldIgnoreException(e):
+            return
+
         # Report the exception using the application's exception handler and logger
         self.__exception_handler.report(
             exception=e,

orionis/failure/contracts/handler.py

@@ -5,6 +5,45 @@ from orionis.services.log.contracts.log_service import ILogger
 
 class IBaseExceptionHandler:
 
+    @abstractmethod
+    def destructureException(self, e: BaseException):
+        """
+        Converts an exception into a structured `Throwable` object containing detailed information.
+
+        Parameters
+        ----------
+        e : BaseException
+            The exception instance to be destructured.
+
+        Returns
+        -------
+        Throwable
+            A `Throwable` object encapsulating the exception's class type, message, arguments, and traceback.
+
+        Notes
+        -----
+        This method extracts the type, message, arguments, and traceback from the provided exception
+        and wraps them in a `Throwable` object for consistent error handling and reporting.
+        """
+        pass
+
+    @abstractmethod
+    def shouldIgnoreException(self, e: BaseException) -> bool:
+        """
+        Determines if the exception should be ignored (not handled) by the handler.
+
+        Parameters
+        ----------
+        e : BaseException
+            The exception instance to check.
+
+        Returns
+        -------
+        bool
+            True if the exception should be ignored, False otherwise.
+        """
+        pass
+
     @abstractmethod
     def report (self, exception: BaseException, log: ILogger) -> Any:
         """

orionis/metadata/framework.py

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

{orionis-0.493.0.dist-info → orionis-0.494.0.dist-info}/METADATA

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

{orionis-0.493.0.dist-info → orionis-0.494.0.dist-info}/RECORD

@@ -93,12 +93,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=f3ZUkRJ1OkKnZtFjLu2QWcqka9Bu9rFDb1n1pgRCufg,3608
+orionis/failure/catch.py,sha256=1-G1U4Udzkd6QSmQ9oKQeUaFjosA9hNfzwmOWVIbUZU,3760
 orionis/failure/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/base/handler.py,sha256=-Q4v4fO8bhmxgRQeMJ0Afx14zKr68rpOt_vRalAdDYs,3963
+orionis/failure/base/handler.py,sha256=1LDcJO4-tgam225jWT0lbh4VzqRSu5iOtcH5JSkMugk,4845
 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=58rJmj9J_Z-kFWPgtRXd3sjLdEpRMXEmVuXzgHSQGy0,976
+orionis/failure/contracts/handler.py,sha256=1WyFx7D9h5chNnOXDQhg6o-RqNfhTHblm_xWzCDu4SM,2161
 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
@@ -217,7 +217,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=PMZJUhO5FoTMzEhda5DJYJz5RxMTCJjuI2P4wN_z1us,4109
+orionis/metadata/framework.py,sha256=JVYrHvNcvIwP-Tu8ZDFmAKPmem6M2lZLP-0c-5oXNp4,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
@@ -391,7 +391,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.493.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.494.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
@@ -538,8 +538,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.493.0.dist-info/METADATA,sha256=c-mmJkE34YSSawOWYy0h2iIMHZDhTr__i_LRMi0JExU,4801
-orionis-0.493.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.493.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.493.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.493.0.dist-info/RECORD,,
+orionis-0.494.0.dist-info/METADATA,sha256=28lRMV-BoMpK4RrqgQVimRte_0zXTJS3W37ZJ6obyuc,4801
+orionis-0.494.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.494.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.494.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.494.0.dist-info/RECORD,,