decoy 2.2.0__tar.gz → 2.2.2__tar.gz

{decoy-2.2.0 → decoy-2.2.2}/PKG-INFO

@@ -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 → decoy-2.2.2}/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-2.2.0 → decoy-2.2.2}/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-2.2.0 → decoy-2.2.2}/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-2.2.0 → decoy-2.2.2}/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-2.2.0 → decoy-2.2.2}/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-2.2.0 → decoy-2.2.2}/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-2.2.0 → decoy-2.2.2}/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.2/pyproject.toml

@@ -0,0 +1,115 @@
+[project]
+name = "decoy"
+version = "2.2.2"
+description = "Opinionated mocking library for Python"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.7"
+authors = [
+    {name = "Michael Cousins", email = "michael@cousins.io>"},
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Testing :: Mocking",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://michael.cousins.io/decoy/"
+Documentation = "https://michael.cousins.io/decoy/"
+Repository = "https://github.com/mcous/decoy"
+Issues = "https://github.com/mcous/decoy/issues"
+Changelog = "https://github.com/mcous/decoy/releases"
+
+[project.entry-points."pytest11"]
+"decoy" = "decoy.pytest_plugin"
+
+[dependency-groups]
+dev = [
+    "poethepoet (==0.19.0) ; python_version < '3.8'",
+    "poethepoet (==0.30.0) ; python_version >= '3.8' and python_version < '3.9'",
+    "poethepoet (==0.35.0) ; python_version >= '3.9'",
+]
+
+test = [
+  "coverage[toml] (==7.2.7) ; python_version < '3.8'",
+  "coverage[toml] (==7.6.1) ; python_version >= '3.8' and python_version < '3.9'",
+  "coverage[toml] (==7.9.1) ; python_version >= '3.9'",
+  "mypy (==1.4.1) ; python_version < '3.8'",
+  "mypy (==1.14.1) ; python_version >= '3.8' and python_version < '3.9'",
+  "mypy (==1.16.0) ; python_version >= '3.9'",
+  "pytest (==7.4.4) ; python_version < '3.8'",
+  "pytest (==8.3.5) ; python_version >= '3.8' and python_version < '3.9'",
+  "pytest (==8.4.0) ; python_version >= '3.9'",
+  "pytest-asyncio (==0.21.2) ; python_version < '3.8'",
+  "pytest-asyncio (==0.24.0) ; python_version >= '3.8' and python_version < '3.9'",
+  "pytest-asyncio (==1.0.0) ; python_version >= '3.9'",
+  "pytest-mypy-plugins (==2.0.0) ; python_version < '3.8'",
+  "pytest-mypy-plugins (==3.1.2) ; python_version >= '3.8' and python_version < '3.9'",
+  "pytest-mypy-plugins (==3.2.0) ; python_version >= '3.9'",
+  "pytest-xdist (==3.5.0) ; python_version < '3.8'",
+  "pytest-xdist (==3.6.1) ; python_version >= '3.8' and python_version < '3.9'",
+  "pytest-xdist (==3.7.0) ; python_version >= '3.9'",
+  "ruff (==0.14.7)"
+]
+
+docs = [
+    "mkdocs (==1.6.1) ; python_version >= '3.10'",
+    "mkdocs-material (==9.6.21) ; python_version >= '3.10'",
+    "mkdocstrings[python] (==0.30.1) ; python_version >= '3.10'"
+]
+
+[tool.poe.tasks]
+all = [
+    "check",
+    "lint",
+    "format-check",
+    "test-once",
+    "coverage",
+    "build-docs",
+    "build-package",
+]
+check = "mypy"
+lint = "ruff check ."
+format = "ruff format ."
+format-check = "ruff format --check ."
+test = "pytest -f"
+test-once = "coverage run --branch --source=decoy -m pytest --mypy-same-process"
+coverage = "coverage report"
+coverage-xml = "coverage xml"
+docs = "mkdocs serve"
+build-docs = "mkdocs build"
+build-package = "poetry build"
+check-ci = ["check", "lint", "format-check"]
+test-ci = ["test-once", "coverage-xml"]
+
+[tool.pytest.ini_options]
+addopts = "--color=yes --mypy-ini-file=tests/typing/mypy.ini --mypy-only-local-stub"
+asyncio_mode = "auto"
+
+[tool.mypy]
+files = ["decoy", "tests"]
+plugins = ["decoy/mypy/plugin.py"]
+strict = true
+show_error_codes = true
+
+[tool.coverage.report]
+exclude_lines = ["@overload", "if TYPE_CHECKING:"]
+
+[tool.ruff]
+target-version = "py37"
+extend-exclude = [".cache"]
+
+[tool.ruff.lint]
+select = ["ANN", "B", "D", "E", "F", "RUF", "W"]
+ignore = ["ANN401", "D107", "E501"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[build-system]
+requires = ["poetry_core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"

decoy-2.2.0/pyproject.toml

@@ -1,101 +0,0 @@
-[tool.poetry]
-name = "decoy"
-version = "2.2.0"
-description = "Opinionated mocking library for Python"
-authors = ["Michael Cousins <michael@cousins.io>"]
-license = "MIT"
-readme = "README.md"
-repository = "https://github.com/mcous/decoy"
-homepage = "https://michael.cousins.io/decoy/"
-documentation = "https://michael.cousins.io/decoy/"
-
-classifiers = [
-    "Development Status :: 5 - Production/Stable",
-    "Intended Audience :: Developers",
-    "Operating System :: OS Independent",
-    "Topic :: Software Development :: Testing",
-    "Topic :: Software Development :: Testing :: Mocking",
-    "Typing :: Typed",
-]
-
-[tool.poetry.urls]
-"Changelog" = "https://github.com/mcous/decoy/releases"
-
-[tool.poetry.dependencies]
-python = "^3.7"
-
-[tool.poetry.group.dev.dependencies]
-poethepoet = "0.19.0"
-
-[tool.poetry.group.test.dependencies]
-coverage = { version = "7.2.7", extras = ["toml"] }
-mypy = [
-    { version = "1.4.1", python = "<3.8" },
-    { version = "1.5.0", python = ">=3.8" },
-]
-pytest = "7.4.0"
-pytest-asyncio = "0.21.1"
-pytest-mypy-plugins = "2.0.0"
-pytest-xdist = "3.5.0"
-ruff = "0.11.0"
-
-[tool.poetry.group.docs.dependencies]
-mkdocs = { version = "1.5.3", python = ">=3.8" }
-mkdocs-material = { version = "9.4.8", python = ">=3.8" }
-mkdocstrings = { version = "0.23.0", extras = ["python"], python = ">=3.8" }
-
-[tool.poe.tasks]
-all = [
-    "check",
-    "lint",
-    "format-check",
-    "test-once",
-    "coverage",
-    "docs-build",
-    "build",
-]
-check = "mypy"
-lint = "ruff check ."
-format = "ruff format ."
-format-check = "ruff format --check ."
-test = "pytest -f"
-test-once = "coverage run --branch --source=decoy -m pytest --mypy-same-process"
-coverage = "coverage report"
-coverage-xml = "coverage xml"
-docs = "mkdocs serve"
-docs-build = "mkdocs build"
-build = "poetry build"
-check-ci = ["check", "lint", "format-check"]
-test-ci = ["test-once", "coverage-xml"]
-build-ci = ["docs-build", "build"]
-
-[tool.poetry.plugins."pytest11"]
-"decoy" = "decoy.pytest_plugin"
-
-[tool.pytest.ini_options]
-addopts = "--color=yes --mypy-ini-file=tests/typing/mypy.ini --mypy-only-local-stub"
-asyncio_mode = "auto"
-
-[tool.mypy]
-files = ["decoy", "tests"]
-plugins = ["decoy/mypy/plugin.py"]
-strict = true
-show_error_codes = true
-
-[tool.coverage.report]
-exclude_lines = ["@overload", "if TYPE_CHECKING:"]
-
-[tool.ruff]
-target-version = "py37"
-extend-exclude = [".cache"]
-
-[tool.ruff.lint]
-select = ["ANN", "B", "D", "E", "F", "RUF", "W"]
-ignore = ["ANN401", "D107", "E501"]
-
-[tool.ruff.lint.pydocstyle]
-convention = "google"
-
-[build-system]
-requires = ["poetry_core>=1.0.0"]
-build-backend = "poetry.core.masonry.api"