decoy 2.2.0__py3-none-any.whl → 2.2.2__py3-none-any.whl

decoy/__init__.py

@@ -3,14 +3,14 @@
 from typing import Any, Callable, Coroutine, Generic, Optional, Union, overload
 
 from . import errors, matchers, warnings
-from .core import DecoyCore, StubCore, PropCore
-from .types import ClassT, ContextValueT, FuncT, ReturnT
 from .context_managers import (
-    ContextManager,
     AsyncContextManager,
-    GeneratorContextManager,
     AsyncGeneratorContextManager,
+    ContextManager,
+    GeneratorContextManager,
 )
+from .core import DecoyCore, PropCore, StubCore
+from .types import ClassT, ContextValueT, FuncT, ReturnT
 
 # ensure decoy does not pollute pytest tracebacks
 __tracebackhide__ = True
@@ -82,7 +82,7 @@ class Decoy:
         spec = cls or func
 
         if spec is None and name is None:
-            raise errors.MockNameRequiredError()
+            raise errors.MockNameRequiredError.create()
 
         return self._core.mock(spec=spec, name=name, is_async=is_async)
 

decoy/errors.py

@@ -19,8 +19,10 @@ class MockNameRequiredError(ValueError):
     [MockNameRequiredError guide]: usage/errors-and-warnings.md#mocknamerequirederror
     """
 
-    def __init__(self) -> None:
-        super().__init__("Mocks without `cls` or `func` require a `name`.")
+    @classmethod
+    def create(cls) -> "MockNameRequiredError":
+        """Create a MockNameRequiredError."""
+        return cls("Mocks without `cls` or `func` require a `name`.")
 
 
 class MissingRehearsalError(ValueError):
@@ -36,8 +38,10 @@ class MissingRehearsalError(ValueError):
     [MissingRehearsalError guide]: usage/errors-and-warnings.md#missingrehearsalerror
     """
 
-    def __init__(self) -> None:
-        super().__init__("Rehearsal not found.")
+    @classmethod
+    def create(cls) -> "MissingRehearsalError":
+        """Create a MissingRehearsalError."""
+        return cls("Rehearsal not found.")
 
 
 class MockNotAsyncError(TypeError):
@@ -68,12 +72,14 @@ class VerifyError(AssertionError):
     calls: Sequence[SpyEvent]
     times: Optional[int]
 
-    def __init__(
-        self,
+    @classmethod
+    def create(
+        cls,
         rehearsals: Sequence[VerifyRehearsal],
         calls: Sequence[SpyEvent],
         times: Optional[int],
-    ) -> None:
+    ) -> "VerifyError":
+        """Create a VerifyError."""
         if times is not None:
             heading = f"Expected exactly {count(times, 'call')}:"
         elif len(rehearsals) == 1:
@@ -88,7 +94,9 @@ class VerifyError(AssertionError):
             include_calls=times is None or times == len(calls),
         )
 
-        super().__init__(message)
-        self.rehearsals = rehearsals
-        self.calls = calls
-        self.times = times
+        result = cls(message)
+        result.rehearsals = rehearsals
+        result.calls = calls
+        result.times = times
+
+        return result

decoy/matchers.py

@@ -28,8 +28,7 @@ See the [matchers guide][] for more details.
 """
 
 from re import compile as compile_re
-from typing import cast, Any, List, Mapping, Optional, Pattern, Type, TypeVar
-
+from typing import Any, List, Mapping, Optional, Pattern, Type, TypeVar, cast
 
 __all__ = [
     "Anything",
@@ -212,9 +211,9 @@ def HasAttributes(attributes: Mapping[str, Any]) -> Any:
 
 
 class _DictMatching:
-    _values: Mapping[str, Any]
+    _values: Mapping[Any, Any]
 
-    def __init__(self, values: Mapping[str, Any]) -> None:
+    def __init__(self, values: Mapping[Any, Any]) -> None:
         self._values = values
 
     def __eq__(self, target: object) -> bool:
@@ -235,7 +234,7 @@ class _DictMatching:
         return f"<DictMatching {self._values!r}>"
 
 
-def DictMatching(values: Mapping[str, Any]) -> Any:
+def DictMatching(values: Mapping[Any, Any]) -> Any:
     """Match any dictionary with the passed in keys / values.
 
     Arguments:

decoy/spy_log.py

@@ -5,13 +5,13 @@ from typing import List, Sequence
 from .errors import MissingRehearsalError
 from .spy_events import (
     AnySpyEvent,
+    PropAccessType,
+    PropRehearsal,
     SpyCall,
     SpyEvent,
     SpyPropAccess,
-    WhenRehearsal,
     VerifyRehearsal,
-    PropAccessType,
-    PropRehearsal,
+    WhenRehearsal,
 )
 
 
@@ -33,10 +33,10 @@ class SpyLog:
         try:
             event = self._log[-1]
         except IndexError as e:
-            raise MissingRehearsalError() from e
+            raise MissingRehearsalError.create() from e
 
         if not isinstance(event, SpyEvent):
-            raise MissingRehearsalError()
+            raise MissingRehearsalError.create()
 
         spy, payload = _apply_ignore_extra_args(event, ignore_extra_args)
 
@@ -59,12 +59,12 @@ class SpyLog:
 
         while len(rehearsals) < count:
             if index < 0:
-                raise MissingRehearsalError()
+                raise MissingRehearsalError.create()
 
             event = self._log[index]
 
             if not isinstance(event, (SpyEvent, PropRehearsal)):
-                raise MissingRehearsalError()
+                raise MissingRehearsalError.create()
 
             if _is_verifiable(event):
                 rehearsal = VerifyRehearsal(
@@ -82,7 +82,7 @@ class SpyLog:
         try:
             event = self._log[-1]
         except IndexError as e:
-            raise MissingRehearsalError() from e
+            raise MissingRehearsalError.create() from e
 
         spy, payload = event
 
@@ -91,7 +91,7 @@ class SpyLog:
             or not isinstance(payload, SpyPropAccess)
             or payload.access_type != PropAccessType.GET
         ):
-            raise MissingRehearsalError()
+            raise MissingRehearsalError.create()
 
         rehearsal = PropRehearsal(spy, payload)
         self._log[-1] = rehearsal

decoy/verifier.py

@@ -2,8 +2,8 @@
 
 from typing import Optional, Sequence
 
-from .spy_events import SpyEvent, VerifyRehearsal, match_event
 from .errors import VerifyError
+from .spy_events import SpyEvent, VerifyRehearsal, match_event
 
 # ensure decoy.verifier does not pollute Pytest tracebacks
 __tracebackhide__ = True
@@ -42,7 +42,7 @@ class Verifier:
         calls_verified = match_count != 0 if times is None else match_count == times
 
         if not calls_verified:
-            raise VerifyError(
+            raise VerifyError.create(
                 rehearsals=rehearsals,
                 calls=calls,
                 times=times,

decoy/warning_checker.py

@@ -9,9 +9,9 @@ from .spy_events import (
     AnySpyEvent,
     SpyCall,
     SpyEvent,
+    SpyRehearsal,
     VerifyRehearsal,
     WhenRehearsal,
-    SpyRehearsal,
     match_event,
 )
 from .warnings import DecoyWarning, MiscalledStubWarning, RedundantVerifyWarning
@@ -78,7 +78,7 @@ def _check_no_miscalled_stubs(all_events: Sequence[AnySpyEvent]) -> None:
 
             if is_stubbed and all(len(c.matching_rehearsals) == 0 for c in calls):
                 _warn(
-                    MiscalledStubWarning(
+                    MiscalledStubWarning.create(
                         calls=[c.event for c in calls],
                         rehearsals=rehearsals,
                     )
@@ -90,8 +90,8 @@ def _check_no_redundant_verify(all_calls: Sequence[AnySpyEvent]) -> None:
     verify_rehearsals = [c for c in all_calls if isinstance(c, VerifyRehearsal)]
 
     for vr in verify_rehearsals:
-        if any(wr for wr in when_rehearsals if wr == vr):
-            _warn(RedundantVerifyWarning(rehearsal=vr))
+        if any(wr for wr in when_rehearsals if wr == vr):  # type: ignore[comparison-overlap]
+            _warn(RedundantVerifyWarning.create(rehearsal=vr))
 
 
 def _warn(warning: DecoyWarning) -> None:

decoy/warnings.py

@@ -9,7 +9,7 @@ import os
 from typing import Sequence
 
 from .spy_events import SpyEvent, SpyRehearsal, VerifyRehearsal
-from .stringify import stringify_call, stringify_error_message, count
+from .stringify import count, stringify_call, stringify_error_message
 
 
 class DecoyWarning(UserWarning):
@@ -31,18 +31,20 @@ class MiscalledStubWarning(DecoyWarning):
     [MiscalledStubWarning guide]: usage/errors-and-warnings.md#miscalledstubwarning
 
     Attributes:
-        rehearsals: The mocks's configured rehearsals.
+        rehearsals: The mock's configured rehearsals.
         calls: Actual calls to the mock.
     """
 
     rehearsals: Sequence[SpyRehearsal]
     calls: Sequence[SpyEvent]
 
-    def __init__(
-        self,
+    @classmethod
+    def create(
+        cls,
         rehearsals: Sequence[SpyRehearsal],
         calls: Sequence[SpyEvent],
-    ) -> None:
+    ) -> "MiscalledStubWarning":
+        """Create a MiscalledStubWarning."""
         heading = os.linesep.join(
             [
                 "Stub was called but no matching rehearsal found.",
@@ -56,9 +58,11 @@ class MiscalledStubWarning(DecoyWarning):
             calls=calls,
         )
 
-        super().__init__(message)
-        self.rehearsals = rehearsals
-        self.calls = calls
+        result = cls(message)
+        result.rehearsals = rehearsals
+        result.calls = calls
+
+        return result
 
 
 class RedundantVerifyWarning(DecoyWarning):
@@ -74,7 +78,11 @@ class RedundantVerifyWarning(DecoyWarning):
     [RedundantVerifyWarning guide]: usage/errors-and-warnings.md#redundantverifywarning
     """
 
-    def __init__(self, rehearsal: VerifyRehearsal) -> None:
+    rehearsal: VerifyRehearsal
+
+    @classmethod
+    def create(cls, rehearsal: VerifyRehearsal) -> "RedundantVerifyWarning":
+        """Create a RedundantVerifyWarning."""
         message = os.linesep.join(
             [
                 "The same rehearsal was used in both a `when` and a `verify`.",
@@ -83,8 +91,11 @@ class RedundantVerifyWarning(DecoyWarning):
                 "See https://michael.cousins.io/decoy/usage/errors-and-warnings/#redundantverifywarning",
             ]
         )
-        super().__init__(message)
-        self.rehearsal = rehearsal
+
+        result = cls(message)
+        result.rehearsal = rehearsal
+
+        return result
 
 
 class IncorrectCallWarning(DecoyWarning):

{decoy-2.2.0.dist-info → decoy-2.2.2.dist-info}/METADATA

@@ -1,29 +1,22 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: decoy
-Version: 2.2.0
+Version: 2.2.2
 Summary: Opinionated mocking library for Python
-License: MIT
+License-Expression: MIT
+License-File: LICENSE
 Author: Michael Cousins
-Author-email: michael@cousins.io
-Requires-Python: >=3.7,<4.0
+Author-email: michael@cousins.io>
+Requires-Python: >=3.7
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Testing :: Mocking
 Classifier: Typing :: Typed
 Project-URL: Changelog, https://github.com/mcous/decoy/releases
 Project-URL: Documentation, https://michael.cousins.io/decoy/
 Project-URL: Homepage, https://michael.cousins.io/decoy/
+Project-URL: Issues, https://github.com/mcous/decoy/issues
 Project-URL: Repository, https://github.com/mcous/decoy
 Description-Content-Type: text/markdown
 

{decoy-2.2.0.dist-info → decoy-2.2.2.dist-info}/RECORD

@@ -1,9 +1,9 @@
-decoy/__init__.py,sha256=wGgiPaajcP3DgnFQZi_6aRiCvrx-rZNNH7hgcu6Zx0Q,11225
+decoy/__init__.py,sha256=v3LUyAxuxFrO2M4Iw0VRX0IM6axFMxPmtgIbBemmwj8,11232
 decoy/call_handler.py,sha256=fuhWr9VAnh0FUvbfWw11fpdQ_GCUE3Hah-EXvdk3gGw,1512
 decoy/context_managers.py,sha256=oYsH99ZPmkaCcqjCrOWInueO5ympHm_ICWmbpFoQzqA,1287
 decoy/core.py,sha256=0YsQFnL4Kw_oDX7jRgOVLw9BGsnNdekymQCd1aq-4sQ,5830
-decoy/errors.py,sha256=SLKXIfklhrfekV-NytDBSqP_FgNIFuiw0EQ3x_GbOv4,2889
-decoy/matchers.py,sha256=_hIyrBZfwRqhQKpiBczN7OVIBw1n3IRfZRv2lhQqgzM,11299
+decoy/errors.py,sha256=mmUAOoQQyXhCLjMcf_3bHMz3PjU7bingIU6sC3hk2B4,3119
+decoy/matchers.py,sha256=TFa3ZLewXPxhuUy_YDktzJWMfdOgfz4jq2TQ9oa6hwk,11298
 decoy/mypy/__init__.py,sha256=GdJCf-gXpYB4SBr-Rm8zCLZQxAUuLjPyUieIWgLmdwA,86
 decoy/mypy/plugin.py,sha256=nCfo4XpDxBRDsInDsvCe6h8t7-1OV0ZCJzIJqTsAU0I,1359
 decoy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -11,15 +11,15 @@ decoy/pytest_plugin.py,sha256=muiWN6zwQPD-AaL4YH6usp-25P4EYjrROTx6wdLE9hM,853
 decoy/spy.py,sha256=cxlwDFxd2dcTb6vFJJGc0B3IuFCPJs2cgVMeB0qNXW4,7581
 decoy/spy_core.py,sha256=b3PTgCkYnijT08ak_iRUKnA95FnmspSRmT8cs_YtjtM,7965
 decoy/spy_events.py,sha256=PFTfkgN7CVWfbVoSSUMSaCSxfRrUMd7U419iwQ1Xofg,2383
-decoy/spy_log.py,sha256=qU-azmm5YmX5mGd4YcAeFAuIS75PESqPNnOUnuq1GoE,3887
+decoy/spy_log.py,sha256=5JcjcH7zHrn12jp7xyrs_UWY7ATcWJkQ4v9oCR_Cclg,3929
 decoy/stringify.py,sha256=6JA2VA9eK-4AtwSSZPnMYT8ucW7EMpGdbTXokbOpgOg,2240
 decoy/stub_store.py,sha256=tVqKOW65NjotVdDhDDXpLfwagKHypMS4WMob71RYk1c,1744
 decoy/types.py,sha256=LXzky6T0RXvS53NoPpVgCi3KVV6KCyB6EvnBl0NaKug,404
-decoy/verifier.py,sha256=fKOTBUHv05FXzwcJuCQIkJTlcELmDp5caJpG2R9Kqo0,1579
-decoy/warning_checker.py,sha256=eaawnwDdrUUFG6u6LSRi3suuKS5wirtZ_lMctWGldCE,3527
-decoy/warnings.py,sha256=sHhuh9wWys8AwcOTag0js8JAzR_BP_a0jATrXAd2M4Y,2969
-decoy-2.2.0.dist-info/LICENSE,sha256=Rxi19kHgqakAsJNG1jMuORmgKx9bI8Pcu_gtzFkhflQ,1078
-decoy-2.2.0.dist-info/METADATA,sha256=L5mBN4FJ8dFSn6dT76t698lIMcNBxY1LyHiHiLid5Kg,7220
-decoy-2.2.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-decoy-2.2.0.dist-info/entry_points.txt,sha256=P2wF8zdthEM-3Yo32kxHDhZDjbW6AE489HPWqnvPLOU,38
-decoy-2.2.0.dist-info/RECORD,,
+decoy/verifier.py,sha256=3ZVqaUJPjaNM9Nue3FK6Zzj15qWskX2CEQXoe_yjUEs,1586
+decoy/warning_checker.py,sha256=OOkcrr_I98Pzs3o9UUNgaihJDHwNiu1LlcEK9hi5ZFs,3577
+decoy/warnings.py,sha256=DLdX1ABPk6QvhJWt5s98uR7rCQFQdJJjSPPXRSX0nXA,3203
+decoy-2.2.2.dist-info/METADATA,sha256=hKPZiHbc6RDbYOJ9iwIZ0wvRhrOn3UYxPSCAqABg9Tc,6855
+decoy-2.2.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+decoy-2.2.2.dist-info/entry_points.txt,sha256=P2wF8zdthEM-3Yo32kxHDhZDjbW6AE489HPWqnvPLOU,38
+decoy-2.2.2.dist-info/licenses/LICENSE,sha256=Rxi19kHgqakAsJNG1jMuORmgKx9bI8Pcu_gtzFkhflQ,1078
+decoy-2.2.2.dist-info/RECORD,,

{decoy-2.2.0.dist-info → decoy-2.2.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.1
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any