catchlib 0.0.0.dev0__tar.gz → 0.0.1__tar.gz

{catchlib-0.0.0.dev0/src/catchlib.egg-info → catchlib-0.0.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: catchlib
-Version: 0.0.0.dev0
-Summary: catchlib
+Version: 0.0.1
+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 :: 2 - Pre-Alpha
 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-0.0.1/README.rst

@@ -0,0 +1,5 @@
+========
+catchlib
+========
+
+Visit the website `https://catchlib.johannes-programming.online/ <https://catchlib.johannes-programming.online/>`_ for more information.

{catchlib-0.0.0.dev0 → catchlib-0.0.1}/pyproject.toml

@@ -9,7 +9,7 @@ authors = [
     { email = "johannes.programming@gmail.com", name = "Johannes" },
 ]
 classifiers = [
-    "Development Status :: 1 - Planning",
+    "Development Status :: 2 - Pre-Alpha",
     "License :: OSI Approved :: MIT License",
     "Natural Language :: English",
     "Operating System :: OS Independent",
@@ -19,12 +19,12 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = []
-description = "catchlib"
+description = "This project allows to catch exceptions easily."
 keywords = []
 name = "catchlib"
 readme = "README.rst"
 requires-python = ">=3.11"
-version = "0.0.0.dev0"
+version = "0.0.1"
 
 [project.license]
 file = "LICENSE.txt"
@@ -33,3 +33,4 @@ file = "LICENSE.txt"
 Download = "https://pypi.org/project/catchlib/#files"
 Index = "https://pypi.org/project/catchlib/"
 Source = "https://github.com/johannes-programming/catchlib/"
+Website = "https://catchlib.johannes-programming.online/"

{catchlib-0.0.0.dev0 → catchlib-0.0.1}/src/catchlib/__init__.py

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

catchlib-0.0.1/src/catchlib/core/__init__.py

@@ -0,0 +1,32 @@
+from contextlib import contextmanager
+from typing import *
+
+__all__ = ["Catcher"]
+
+
+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-0.0.1/src/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 → catchlib-0.0.1/src/catchlib.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: catchlib
-Version: 0.0.0.dev0
-Summary: catchlib
+Version: 0.0.1
+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 :: 2 - Pre-Alpha
 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-0.0.0.dev0 → catchlib-0.0.1}/src/catchlib.egg-info/SOURCES.txt

@@ -4,11 +4,10 @@ README.rst
 pyproject.toml
 setup.cfg
 src/catchlib/__init__.py
-src/catchlib/__main__.py
 src/catchlib.egg-info/PKG-INFO
 src/catchlib.egg-info/SOURCES.txt
 src/catchlib.egg-info/dependency_links.txt
 src/catchlib.egg-info/top_level.txt
 src/catchlib/core/__init__.py
 src/catchlib/tests/__init__.py
-src/catchlib/tests/test_1984.py
+src/catchlib/tests/test_0.py

catchlib-0.0.0.dev0/README.rst

@@ -1,37 +0,0 @@
-========
-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``!

catchlib-0.0.0.dev0/src/catchlib/__main__.py

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

catchlib-0.0.0.dev0/src/catchlib/core/__init__.py

@@ -1,8 +0,0 @@
-from typing import *
-
-__all__ = ["main"]
-
-
-def main(args: Optional[Iterable] = None) -> None:
-    "This function prints 'Hello World!'."
-    print("Hello World!")

catchlib-0.0.0.dev0/src/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()