catchlib 0.0.0.dev0__py3-none-any.whl → 1.0.0__py3-none-any.whl

catchlib/__init__.py

@@ -1,5 +1,2 @@
 from catchlib.core import *
 from catchlib.tests import *
-
-if __name__ == "__main__":
-    main()

catchlib/core/__init__.py

@@ -1,8 +1,32 @@
+from contextlib import contextmanager
 from typing import *
 
-__all__ = ["main"]
+__all__ = ["Catcher"]
 
 
-def main(args: Optional[Iterable] = None) -> None:
-    "This function prints 'Hello World!'."
-    print("Hello World!")
+class Catcher:
+
+    "This class catches exceptions."
+
+    __slots__ = ("_caught",)
+
+    caught: Optional[BaseException]
+
+    def __init__(self: Self) -> None:
+        "This magic method initializes the current instance."
+        self._caught = None
+
+    @contextmanager
+    def catch(self: Self, *args: type[BaseException]) -> Generator[Self, None, None]:
+        "This contextmanager catches exceptions."
+        self._caught = None
+        exc: BaseException
+        try:
+            yield self
+        except args as exc:
+            self._caught = exc
+
+    @property
+    def caught(self: Self) -> Optional[BaseException]:
+        "This property stores the caught exception."
+        return self._caught

catchlib/tests/test_0.py

@@ -0,0 +1,70 @@
+import unittest
+from typing import *
+
+from catchlib.core import Catcher
+
+
+class TestCatcher(unittest.TestCase):
+    def test_captures_matching_exception(self: Self) -> None:
+        catcher: Catcher = Catcher()
+        with catcher.catch(ValueError):
+            raise ValueError("bad value")
+        self.assertIsNotNone(catcher.caught)
+        self.assertIsInstance(catcher.caught, ValueError)
+        self.assertEqual(str(catcher.caught), "bad value")
+
+    def test_no_exception_leaves_caught_none(self: Self) -> None:
+        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()
+        with catcher.catch(ValueError, KeyError):
+            raise KeyError("missing")
+        self.assertIsNotNone(catcher.caught)
+        self.assertIsInstance(catcher.caught, KeyError)
+        self.assertEqual(
+            str(catcher.caught), "'missing'"
+        )  # KeyError stringifies with quotes
+
+    def test_non_matching_exception_propagates_and_does_not_set_caught(
+        self: Self,
+    ) -> None:
+        catcher: Catcher = Catcher()
+        with self.assertRaises(ZeroDivisionError):
+            with catcher.catch(ValueError, KeyError):
+                1 / 0  # ZeroDivisionError not in capture set
+        # Since the exception propagated out, Catcher should not have recorded anything
+        self.assertIsNone(catcher.caught)
+
+    def test_reuse_and_reset_semantics(self: Self) -> None:
+        catcher: Catcher = Catcher()
+
+        # First, capture an exception
+        with catcher.catch(RuntimeError):
+            raise RuntimeError("first")
+        self.assertIsInstance(catcher.caught, RuntimeError)
+
+        # Next, a clean block should reset caught to None
+        with catcher.catch(RuntimeError):
+            pass
+        self.assertIsNone(catcher.caught)
+
+        # Finally, capture another (different) exception type by passing multiple
+        with catcher.catch(RuntimeError, TypeError):
+            raise TypeError("second")
+        self.assertIsInstance(catcher.caught, TypeError)
+
+    def test_empty_type_tuple_never_catches(self: Self) -> None:
+        catcher: Catcher = Catcher()
+        # Passing no types should behave like catching nothing: exception propagates
+        with self.assertRaises(ValueError):
+            with catcher.catch():
+                raise ValueError("won't be caught")
+        self.assertIsNone(catcher.caught)
+
+
+if __name__ == "__main__":
+    unittest.main()

{catchlib-0.0.0.dev0.dist-info → catchlib-1.0.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: catchlib
-Version: 0.0.0.dev0
-Summary: catchlib
+Version: 1.0.0
+Summary: This project allows to catch exceptions easily.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
         
@@ -27,7 +27,8 @@ License: The MIT License (MIT)
 Project-URL: Download, https://pypi.org/project/catchlib/#files
 Project-URL: Index, https://pypi.org/project/catchlib/
 Project-URL: Source, https://github.com/johannes-programming/catchlib/
-Classifier: Development Status :: 1 - Planning
+Project-URL: Website, https://catchlib.johannes-programming.online/
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
@@ -44,36 +45,4 @@ Dynamic: license-file
 catchlib
 ========
 
-Overview
---------
-
-catchlib
-
-Installation
-------------
-
-To install ``catchlib``, you can use ``pip``. Open your terminal and run:
-
-.. code-block:: bash
-
-    pip install catchlib
-
-License
--------
-
-This project is licensed under the MIT License.
-
-Links
------
-
-* `Download <https://pypi.org/project/catchlib/#files>`_
-* `Index <https://pypi.org/project/catchlib/>`_
-* `Source <https://github.com/johannes-programming/catchlib/>`_
-
-Credits
--------
-
-* Author: Johannes
-* Email: `johannes.programming@gmail.com <mailto:johannes.programming@gmail.com>`_
-
-Thank you for using ``catchlib``!
+Visit the website `https://catchlib.johannes-programming.online/ <https://catchlib.johannes-programming.online/>`_ for more information.

catchlib-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+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,,

catchlib/__main__.py

@@ -1,4 +0,0 @@
-from catchlib import main
-
-if __name__ == "__main__":
-    main()

catchlib/tests/test_1984.py

@@ -1,11 +0,0 @@
-import unittest
-from typing import *
-
-
-class Test1984(unittest.TestCase):
-    def test_1984(self: Self) -> None:
-        self.assertEqual(2 + 2, 4, "Ignorance is Strength")
-
-
-if __name__ == "__main__":
-    unittest.main()

catchlib-0.0.0.dev0.dist-info/RECORD

@@ -1,10 +0,0 @@
-catchlib/__init__.py,sha256=cQbMQNae02UxVtDduzj3ZCzH87hbyJGbR5oXA_B0oCw,96
-catchlib/__main__.py,sha256=dN8d0Nu8AGoONqnHvThcjtCb9E9YcNFGlaVHYYTeK4w,65
-catchlib/core/__init__.py,sha256=Tr3CwIPY695IbF4DrKHrDes1AKd_iJgddUP46jxKHSw,163
-catchlib/tests/__init__.py,sha256=F79E9ssYcoufZpYJ4I6XSvZTR0wkvc9r-5K3XpYvXsY,387
-catchlib/tests/test_1984.py,sha256=_ami0cAP8vU0C8RpQhP1tLWnLFGTaeHlOG5O60RVKv8,222
-catchlib-0.0.0.dev0.dist-info/licenses/LICENSE.txt,sha256=fOh9FHccUt9OcJPBaVJ482GX4yrl_FxCUk9YRZ53JOI,1074
-catchlib-0.0.0.dev0.dist-info/METADATA,sha256=75xWXIpQsdmWirkcj_HaJpuMasBk7NDuoWrb-e4K5aA,2645
-catchlib-0.0.0.dev0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-catchlib-0.0.0.dev0.dist-info/top_level.txt,sha256=pZsP_Y2Suk_fAyIQrw4g81DUtgZBRIWzb-5Bk-0jmZs,9
-catchlib-0.0.0.dev0.dist-info/RECORD,,