catchlib 1.0.0__py3-none-any.whl → 1.0.2__py3-none-any.whl

catchlib/core/__init__.py

@@ -1,11 +1,12 @@
 from contextlib import contextmanager
 from typing import *
 
+from overloadable import Overloadable
+
 __all__ = ["Catcher"]
 
 
 class Catcher:
-
     "This class catches exceptions."
 
     __slots__ = ("_caught",)
@@ -30,3 +31,24 @@ class Catcher:
     def caught(self: Self) -> Optional[BaseException]:
         "This property stores the caught exception."
         return self._caught
+
+    @Overloadable
+    def release(self: Self, *args: Any, **kwargs: Any) -> bool:
+        "This method raises the caught exception."
+        return bool(len(args) + len(kwargs))
+
+    @release.overload(False)
+    def release(self: Self) -> None:
+        "This method raises the caught exception."
+        exc: BaseException = self.caught
+        self._caught = None
+        if exc is not None:
+            raise exc
+
+    @release.overload(True)
+    def release(self: Self, cause: Optional[BaseException]) -> None:
+        "This method raises the caught exception."
+        exc: BaseException = self.caught
+        self._caught = None
+        if exc is not None:
+            raise exc from cause

catchlib/tests/__init__.py

@@ -5,8 +5,12 @@ __all__ = ["test"]
 
 def test() -> unittest.TextTestRunner:
     "This function runs all the tests."
-    loader: unittest.TestLoader = unittest.TestLoader()
-    tests: unittest.TestSuite = loader.discover(start_dir="catchlib.tests")
-    runner: unittest.TextTestRunner = unittest.TextTestRunner()
-    result: unittest.TextTestResult = runner.run(tests)
+    loader: unittest.TestLoader
+    tests: unittest.TestSuite
+    runner: unittest.TextTestRunner
+    result: unittest.TextTestResult
+    loader = unittest.TestLoader()
+    tests = loader.discover(start_dir="catchlib.tests")
+    runner = unittest.TextTestRunner()
+    result = runner.run(tests)
     return result

catchlib/tests/test_0.py

@@ -6,7 +6,8 @@ from catchlib.core import Catcher
 
 class TestCatcher(unittest.TestCase):
     def test_captures_matching_exception(self: Self) -> None:
-        catcher: Catcher = Catcher()
+        catcher: Catcher
+        catcher = Catcher()
         with catcher.catch(ValueError):
             raise ValueError("bad value")
         self.assertIsNotNone(catcher.caught)
@@ -14,13 +15,15 @@ class TestCatcher(unittest.TestCase):
         self.assertEqual(str(catcher.caught), "bad value")
 
     def test_no_exception_leaves_caught_none(self: Self) -> None:
-        catcher: Catcher = Catcher()
+        catcher: Catcher
+        catcher = Catcher()
         with catcher.catch(ValueError):
             pass
         self.assertIsNone(catcher.caught)
 
     def test_captures_one_of_multiple_types(self: Self) -> None:
-        catcher: Catcher = Catcher()
+        catcher: Catcher
+        catcher = Catcher()
         with catcher.catch(ValueError, KeyError):
             raise KeyError("missing")
         self.assertIsNotNone(catcher.caught)
@@ -32,7 +35,8 @@ class TestCatcher(unittest.TestCase):
     def test_non_matching_exception_propagates_and_does_not_set_caught(
         self: Self,
     ) -> None:
-        catcher: Catcher = Catcher()
+        catcher: Catcher
+        catcher = Catcher()
         with self.assertRaises(ZeroDivisionError):
             with catcher.catch(ValueError, KeyError):
                 1 / 0  # ZeroDivisionError not in capture set
@@ -40,7 +44,8 @@ class TestCatcher(unittest.TestCase):
         self.assertIsNone(catcher.caught)
 
     def test_reuse_and_reset_semantics(self: Self) -> None:
-        catcher: Catcher = Catcher()
+        catcher: Catcher
+        catcher = Catcher()
 
         # First, capture an exception
         with catcher.catch(RuntimeError):
@@ -58,7 +63,8 @@ class TestCatcher(unittest.TestCase):
         self.assertIsInstance(catcher.caught, TypeError)
 
     def test_empty_type_tuple_never_catches(self: Self) -> None:
-        catcher: Catcher = Catcher()
+        catcher: Catcher
+        catcher = Catcher()
         # Passing no types should behave like catching nothing: exception propagates
         with self.assertRaises(ValueError):
             with catcher.catch():

{catchlib-1.0.0.dist-info → catchlib-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: catchlib
-Version: 1.0.0
+Version: 1.0.2
 Summary: This project allows to catch exceptions easily.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
@@ -39,6 +39,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
+Requires-Dist: overloadable<2,>=1.0.9
 Dynamic: license-file
 
 ========

catchlib-1.0.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+catchlib/__init__.py,sha256=LmWT7JBQPWFiRLTuaTqgduz9WH_4q2EyEtZMaBLIWe8,57
+catchlib/core/__init__.py,sha256=duXNKcfqWK1rh7mWO9zSdtiJYDFxwpcTrjHQZUk7yPk,1524
+catchlib/tests/__init__.py,sha256=rNCdqp3ppovaIKlKOHLcBqF2-JgrV9wdn8tQF0-nl7c,430
+catchlib/tests/test_0.py,sha256=AyTakeyPgVf73ijJifEtN3jls8cJEhEEhEug9lpOTfk,2684
+catchlib-1.0.2.dist-info/licenses/LICENSE.txt,sha256=fOh9FHccUt9OcJPBaVJ482GX4yrl_FxCUk9YRZ53JOI,1074
+catchlib-1.0.2.dist-info/METADATA,sha256=hii-Jp9MAoLr_MnrPLjT1UIaj8Zcl_xyCW0j0uf0t5o,2349
+catchlib-1.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+catchlib-1.0.2.dist-info/top_level.txt,sha256=pZsP_Y2Suk_fAyIQrw4g81DUtgZBRIWzb-5Bk-0jmZs,9
+catchlib-1.0.2.dist-info/RECORD,,

{catchlib-1.0.0.dist-info → catchlib-1.0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

catchlib-1.0.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-catchlib/__init__.py,sha256=LmWT7JBQPWFiRLTuaTqgduz9WH_4q2EyEtZMaBLIWe8,57
-catchlib/core/__init__.py,sha256=RGJlPffKlyWeES0noN2qHrJeDXNXv0QVLNpk-Fe_jG8,791
-catchlib/tests/__init__.py,sha256=F79E9ssYcoufZpYJ4I6XSvZTR0wkvc9r-5K3XpYvXsY,387
-catchlib/tests/test_0.py,sha256=3GfPlhQRfGxj5fxKtMd--_HwAeE_7RbuRtrltnPHGDQ,2588
-catchlib-1.0.0.dist-info/licenses/LICENSE.txt,sha256=fOh9FHccUt9OcJPBaVJ482GX4yrl_FxCUk9YRZ53JOI,1074
-catchlib-1.0.0.dist-info/METADATA,sha256=U_agBbPRK5aLHGgzH5qGaGg1uuUyIDZOgtfLsDEpd0g,2311
-catchlib-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-catchlib-1.0.0.dist-info/top_level.txt,sha256=pZsP_Y2Suk_fAyIQrw4g81DUtgZBRIWzb-5Bk-0jmZs,9
-catchlib-1.0.0.dist-info/RECORD,,