requiresthat 2025.6.16.0__tar.gz → 2025.6.17.1__tar.gz

{requiresthat-2025.6.16.0 → requiresthat-2025.6.17.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: requiresthat
-Version: 2025.6.16.0
-Summary: Decorate an instance method with pre- and/or postconditions that must be fulfilled
+Version: 2025.6.17.1
+Summary: Support for requirements-assisted development
 Author-email: Ann T Ropea <bedhanger@gmx.de>
 License-Expression: MIT
 Project-URL: Homepage, https://gitlab.com/bedhanger/mwe/-/tree/master/python/requiresthat

{requiresthat-2025.6.16.0 → requiresthat-2025.6.17.1}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "requiresthat"
-version = "2025.6.16.0"
+version = "2025.6.17.1"
 authors = [
     {name = "Ann T Ropea", email = "bedhanger@gmx.de"},
 ]
-description = "Decorate an instance method with pre- and/or postconditions that must be fulfilled"
+description = "Support for requirements-assisted development"
 readme = "README.rst"
 license = "MIT"
 dependencies = []

requiresthat-2025.6.17.1/src/requiresthat/__init__.py

@@ -0,0 +1,8 @@
+from ._requires import (
+    requires,
+    RequirementNotFulfilledError,
+    NoCallableConstructError,
+    APRIORI,
+    POSTMORTEM,
+    BEFOREANDAFTER,
+)

requiresthat-2025.6.17.1/src/requiresthat/_exceptions.py

@@ -0,0 +1,32 @@
+import textwrap
+
+class RequirementNotFulfilledError(Exception):
+    """Raise this when a requirement is found wanting"""
+
+    def __init__(self, that, when, msg=None):
+        """Show a default or a user-provided message indicating that some condition is unmet"""
+
+        self.default_msg = textwrap.dedent(f"""
+            {that!r} ({when.name!r}) does not hold
+        """).strip()
+
+        # Call the base class' constructor to init the exception class
+        super().__init__(msg or self.default_msg)
+
+class NoCallableConstructError(Exception):
+    """Raise this when a construct is not callable"""
+
+    def __init__(self, construct, msg=None):
+        """Show a default or a user-provided message"""
+
+        self.default_msg = textwrap.dedent(f"""
+            {construct!r} does not seem to be callable
+
+            You have managed to place the decorator before a construct that is not callable
+            *without* tripping the Python interpreter.  Maybe you are a wizard?
+
+            But, no, we can't carry on like that.  Sorry!
+        """).strip()
+
+        # Call the base class' constructor to init the exception class
+        super().__init__(msg or self.default_msg)

{requiresthat-2025.6.16.0 → requiresthat-2025.6.17.1}/src/requiresthat/_requires.py

@@ -4,7 +4,7 @@ from typing import Optional, Callable
 from functools import wraps
 
 from ._when import When, APRIORI, POSTMORTEM, BEFOREANDAFTER
-from ._exceptions import RequirementNotFulfilledError
+from ._exceptions import RequirementNotFulfilledError, NoCallableConstructError
 
 def requires(that, when: When = APRIORI) -> Optional[Callable]:
     """Require <that> of the decoratee, and require it <when>"""
@@ -18,6 +18,11 @@ def requires(that, when: When = APRIORI) -> Optional[Callable]:
 
             The wrapping stops here...
             """
+            try:
+                assert callable(func)
+            except AssertionError as exc:
+                raise NoCallableConstructError(func) from exc
+
             try:
                 if when == APRIORI:
                     assert eval(that)

{requiresthat-2025.6.16.0 → requiresthat-2025.6.17.1}/src/requiresthat.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: requiresthat
-Version: 2025.6.16.0
-Summary: Decorate an instance method with pre- and/or postconditions that must be fulfilled
+Version: 2025.6.17.1
+Summary: Support for requirements-assisted development
 Author-email: Ann T Ropea <bedhanger@gmx.de>
 License-Expression: MIT
 Project-URL: Homepage, https://gitlab.com/bedhanger/mwe/-/tree/master/python/requiresthat

requiresthat-2025.6.16.0/src/requiresthat/__init__.py

@@ -1 +0,0 @@
-from ._requires import requires, RequirementNotFulfilledError, APRIORI, POSTMORTEM, BEFOREANDAFTER

requiresthat-2025.6.16.0/src/requiresthat/_exceptions.py

@@ -1,15 +0,0 @@
-"""Raise this when a requirement is found wanting"""
-
-import textwrap
-
-class RequirementNotFulfilledError(Exception):
-
-    def __init__(self, that, when, msg=None):
-        """Show a default or a user-provided message indicating that some condition is unmet"""
-
-        self.default_msg = textwrap.dedent(f"""
-            {that!r} ({when.name!r}) does not hold
-        """).strip()
-
-        # Call the base class' constructor to init the exception class
-        super().__init__(msg or self.default_msg)