requiresthat 2025.6.17.1__py3-none-any.whl → 2025.6.18.2__py3-none-any.whl

requiresthat/_exceptions.py

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

requiresthat/_requires.py

@@ -22,24 +22,40 @@ def requires(that, when: When = APRIORI) -> Optional[Callable]:
                 assert callable(func)
             except AssertionError as exc:
                 raise NoCallableConstructError(func) from exc
-
-            try:
+            else:
+                # Since we want to give detailed sub-failure diax in case of BEFOREANDAFTER,
+                # economisng on the ifs below is tricky.
                 if when == APRIORI:
-                    assert eval(that)
-                    # We can use a return here :-)
-                    return func(self, *pargs, **kwargs)
+                    try:
+                        assert eval(that)
+                    except AssertionError as exc:
+                        raise RequirementNotFulfilledError(that, when) from exc
+                    else:
+                        func(self, *pargs, **kwargs)
+
                 elif when == POSTMORTEM:
                     func(self, *pargs, **kwargs)
-                    assert eval(that)
+                    try:
+                        assert eval(that)
+                    except AssertionError as exc:
+                        raise RequirementNotFulfilledError(that, when) from exc
+
                 elif when == BEFOREANDAFTER:
-                    assert eval(that)
-                    func(self, *pargs, **kwargs)
-                    assert eval(that)
+                    try:
+                        assert eval(that)
+                    except AssertionError as exc:
+                        raise RequirementNotFulfilledError(that, when, APRIORI) from exc
+                    else:
+                        func(self, *pargs, **kwargs)
+                    try:
+                        assert eval(that)
+                    except AssertionError as exc:
+                        raise RequirementNotFulfilledError(that, when, POSTMORTEM) from exc
+
                 # We don't need an else clause; trying to enlist something that's not in the enum
                 # will be penalised with an AttributeError, and small typos will be healed with a
                 # suggestion as to what you might have meant.
-            except AssertionError as exc:
-                raise RequirementNotFulfilledError(that, when) from exc
+
         return inner_wrapper
 
     return func_wrapper

{requiresthat-2025.6.17.1.dist-info → requiresthat-2025.6.18.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: requiresthat
-Version: 2025.6.17.1
+Version: 2025.6.18.2
 Summary: Support for requirements-assisted development
 Author-email: Ann T Ropea <bedhanger@gmx.de>
 License-Expression: MIT
@@ -35,12 +35,14 @@ Example usage
     X = C(data='spam')
     X.method()
 
-The ``that`` can be almost any valid Python statement which can be evaluated for its veracity, and
-whose result will decide whether or not the method fires/will be considered a success.
+The ``that`` can be almost any valid Python statement which can be evaluated and whose veracity can
+be asserted, and the result thereof will decide whether or not the method fires/will be considered a
+success.
 
 The parameter ``when`` decides if the condition is a-priori, post-mortem, or before-and-after.
 The default is a-priori, meaning a precondition.  Note that before-and-after does *not* mean during;
 you cannot mandate an invariant this way!
 
 ``RequirementNotFulfilledError`` is the exception you have to deal with in case a condition is not
-met.
+met.  ``NoCallableConstructError`` gets raised should you apply the decorator to a construct that is
+not callable.

requiresthat-2025.6.18.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+requiresthat/__init__.py,sha256=VTyJru4K2_e7UEa0od6kXU7M8ovfD176GXEXqtNf-nY,154
+requiresthat/_exceptions.py,sha256=-Q9lhvHnSapP_UGMAnlXxwDaGcxagULIe5oP5h8a2IU,1275
+requiresthat/_requires.py,sha256=5hQMT5T5VZuQj6W13108j_cedx4wKzJ7Kt4xseOR4cI,2447
+requiresthat/_when.py,sha256=VoGuvoG9WDEMIPeKnxAsjMTaCMhgSszf4xxa1vLn5aU,299
+requiresthat-2025.6.18.2.dist-info/METADATA,sha256=ap9RNE7_6pymDKgOAS9E-a8RbgvPFD5SQBMUC2c6gCk,1709
+requiresthat-2025.6.18.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+requiresthat-2025.6.18.2.dist-info/top_level.txt,sha256=mUgMTpAG75GYtt5_rVajUyWp-O_1VrrkqRo_hY9L9So,13
+requiresthat-2025.6.18.2.dist-info/RECORD,,

requiresthat-2025.6.17.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-requiresthat/__init__.py,sha256=VTyJru4K2_e7UEa0od6kXU7M8ovfD176GXEXqtNf-nY,154
-requiresthat/_exceptions.py,sha256=8675wEink7JD3mBsOYCWVL5KYpNQMZ5IQ0C7M2CJ1LU,1186
-requiresthat/_requires.py,sha256=zp99m8m3kRTpS8XKHLBZ0r0eH3skDJEMeKTAZIh6PkU,1748
-requiresthat/_when.py,sha256=VoGuvoG9WDEMIPeKnxAsjMTaCMhgSszf4xxa1vLn5aU,299
-requiresthat-2025.6.17.1.dist-info/METADATA,sha256=HPpmJgWGi2gEtIUQEaCrOezW6MgFVPxrafOSo2Gk3PM,1575
-requiresthat-2025.6.17.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-requiresthat-2025.6.17.1.dist-info/top_level.txt,sha256=mUgMTpAG75GYtt5_rVajUyWp-O_1VrrkqRo_hY9L9So,13
-requiresthat-2025.6.17.1.dist-info/RECORD,,