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

decoy/__init__.py

@@ -1,4 +1,5 @@
 """Decoy stubbing and spying library."""
+
 from typing import Any, Callable, Coroutine, Generic, Optional, Union, overload
 
 from . import errors, matchers, warnings
@@ -40,16 +41,13 @@ class Decoy:
         self._core = DecoyCore()
 
     @overload
-    def mock(self, *, cls: Callable[..., ClassT]) -> ClassT:
-        ...
+    def mock(self, *, cls: Callable[..., ClassT]) -> ClassT: ...
 
     @overload
-    def mock(self, *, func: FuncT) -> FuncT:
-        ...
+    def mock(self, *, func: FuncT) -> FuncT: ...
 
     @overload
-    def mock(self, *, name: str, is_async: bool = False) -> Any:
-        ...
+    def mock(self, *, name: str, is_async: bool = False) -> Any: ...
 
     def mock(
         self,
@@ -255,29 +253,25 @@ class Stub(Generic[ReturnT]):
     def then_enter_with(
         self: "Stub[ContextManager[ContextValueT]]",
         value: ContextValueT,
-    ) -> None:
-        ...
+    ) -> None: ...
 
     @overload
     def then_enter_with(
         self: "Stub[AsyncContextManager[ContextValueT]]",
         value: ContextValueT,
-    ) -> None:
-        ...
+    ) -> None: ...
 
     @overload
     def then_enter_with(
         self: "Stub[GeneratorContextManager[ContextValueT]]",
         value: ContextValueT,
-    ) -> None:
-        ...
+    ) -> None: ...
 
     @overload
     def then_enter_with(
         self: "Stub[AsyncGeneratorContextManager[ContextValueT]]",
         value: ContextValueT,
-    ) -> None:
-        ...
+    ) -> None: ...
 
     def then_enter_with(
         self: Union[
@@ -347,4 +341,4 @@ class Prop(Generic[ReturnT]):
         self._core.delete()
 
 
-__all__ = ["Decoy", "Stub", "Prop", "matchers", "warnings", "errors"]
+__all__ = ["Decoy", "Prop", "Stub", "errors", "matchers", "warnings"]

decoy/call_handler.py

@@ -1,4 +1,5 @@
 """Spy call handling."""
+
 from typing import Any, NamedTuple, Optional
 
 from .spy_log import SpyLog

decoy/context_managers.py

@@ -1,4 +1,5 @@
 """Wrappers around contextlib types and fallbacks."""
+
 from typing import Any, AsyncContextManager, ContextManager, Generic, TypeVar
 
 from contextlib import (
@@ -44,6 +45,6 @@ __all__ = [
     "AsyncContextManager",
     "AsyncGeneratorContextManager",
     "ContextManager",
-    "GeneratorContextManager",
     "ContextWrapper",
+    "GeneratorContextManager",
 ]

decoy/core.py

@@ -1,4 +1,5 @@
 """Decoy implementation logic."""
+
 import inspect
 from typing import Any, Callable, Optional
 

decoy/errors.py

@@ -4,6 +4,7 @@ See the [errors guide][] for more details.
 
 [errors guide]: usage/errors-and-warnings.md#errors
 """
+
 from typing import Optional, Sequence
 
 from .spy_events import SpyEvent, VerifyRehearsal

decoy/matchers.py

@@ -26,20 +26,42 @@ See the [matchers guide][] for more details.
     Identity comparisons (`is`) will not work with matchers. Decoy only uses
     equality comparisons (`==`) for stubbing and verification.
 """
+
 from re import compile as compile_re
 from typing import cast, Any, List, Mapping, Optional, Pattern, Type, TypeVar
 
 
 __all__ = [
     "Anything",
+    "Captor",
+    "ErrorMatching",
     "IsA",
     "IsNot",
     "StringMatching",
-    "ErrorMatching",
-    "Captor",
 ]
 
 
+class _AnythingOrNone:
+    def __eq__(self, target: object) -> bool:
+        return True
+
+    def __repr__(self) -> str:
+        """Return a string representation of the matcher."""
+        return "<AnythingOrNone>"
+
+
+def AnythingOrNone() -> Any:
+    """Match anything including None.
+
+    !!! example
+        ```python
+        assert "foobar" == AnythingOrNone()
+        assert None == AnythingOrNone()
+        ```
+    """
+    return _AnythingOrNone()
+
+
 class _Anything:
     def __eq__(self, target: object) -> bool:
         """Return true if target is not None."""
@@ -228,6 +250,41 @@ def DictMatching(values: Mapping[str, Any]) -> Any:
     return _DictMatching(values)
 
 
+class _ListMatching:
+    _values: List[Any]
+
+    def __init__(self, values: List[Any]) -> None:
+        self._values = values
+
+    def __eq__(self, target: object) -> bool:
+        """Return true if target matches all given values."""
+        if not hasattr(target, "__iter__"):
+            return False
+
+        return all(
+            any(item == target_item for target_item in target) for item in self._values
+        )
+
+    def __repr__(self) -> str:
+        """Return a string representation of the matcher."""
+        return f"<ListMatching {self._values!r}>"
+
+
+def ListMatching(values: List[Any]) -> Any:
+    """Match any list with the passed in values.
+
+    Arguments:
+        values: Values to check.
+
+    !!! example
+        ```python
+        value = [1, 2, 3]
+        assert value == matchers.ListMatching([1, 2])
+        ```
+    """
+    return _ListMatching(values)
+
+
 class _StringMatching:
     _pattern: Pattern[str]
 
@@ -270,7 +327,7 @@ class _ErrorMatching:
 
     def __eq__(self, target: object) -> bool:
         """Return true if target is not self._reject_value."""
-        error_match = type(target) == self._error_type
+        error_match = type(target) is self._error_type
         message_match = (
             str(target) == self._string_matcher
             if self._string_matcher is not None

decoy/mypy/__init__.py

@@ -1,4 +1,5 @@
 """Decoy mypy plugin entrypoint."""
+
 from .plugin import plugin
 
 __all__ = ["plugin"]

decoy/mypy/plugin.py

@@ -1,4 +1,5 @@
 """Decoy mypy plugin."""
+
 from typing import Callable, Optional, Type as ClassType
 
 from mypy.errorcodes import FUNC_RETURNS_VALUE

decoy/pytest_plugin.py

@@ -4,6 +4,7 @@ The plugin will be registered with pytest when you install Decoy. It adds a
 fixture without modifying any other pytest behavior. Its usage is optional
 but highly recommended.
 """
+
 from typing import Iterable
 
 import pytest

decoy/spy.py

@@ -3,6 +3,7 @@
 Classes in this module are heavily inspired by the
 [unittest.mock library](https://docs.python.org/3/library/unittest.mock.html).
 """
+
 import inspect
 from types import TracebackType
 from typing import Any, ContextManager, Dict, Optional, Type, Union, cast, overload
@@ -186,14 +187,12 @@ class SpyCreator:
         self._decoy_spy_call_handler = call_handler
 
     @overload
-    def create(self, *, core: SpyCore) -> AnySpy:
-        ...
+    def create(self, *, core: SpyCore) -> AnySpy: ...
 
     @overload
     def create(
         self, *, spec: Optional[object], name: Optional[str], is_async: bool
-    ) -> AnySpy:
-        ...
+    ) -> AnySpy: ...
 
     def create(
         self,

decoy/spy_core.py

@@ -1,11 +1,22 @@
 """Core spy logic."""
+
 import inspect
 import functools
 import warnings
-from typing import Any, Dict, NamedTuple, Optional, Tuple, Type, Union, get_type_hints
+from typing import (
+    Any,
+    Dict,
+    NamedTuple,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+    Sequence,
+    get_type_hints,
+)
 
 from .spy_events import SpyInfo
-from .warnings import IncorrectCallWarning, MissingSpecAttributeWarning
+from .warnings import IncorrectCallWarning
 
 
 class _FROM_SOURCE:
@@ -136,12 +147,7 @@ class SpyCore:
                     # signature reporting by wrapping it in a partial
                     child_source = functools.partial(child_source, None)
 
-        if child_source is None and source is not None:
-            # stacklevel: 4 ensures warning is linked to call location
-            warnings.warn(
-                MissingSpecAttributeWarning(f"{self._name} has no attribute '{name}'"),
-                stacklevel=4,
-            )
+        child_source = _unwrap_optional(child_source)
 
         return SpyCore(
             source=child_source,
@@ -215,3 +221,24 @@ def _get_type_hints(obj: Any) -> Dict[str, Any]:
         return get_type_hints(obj)
     except Exception:
         return {}
+
+
+def _unwrap_optional(source: Any) -> Any:
+    """Return the source's base type if it's a optional.
+
+    If the type is a union of more than just T | None,
+    bail out and return None to avoid potentially false warnings.
+    """
+    origin = getattr(source, "__origin__", None)
+    args: Sequence[Any] = getattr(source, "__args__", ())
+
+    # TODO(mc, 2025-03-19): support larger unions? might be a lot of work for little payoff
+    if origin is Union:
+        if len(args) == 2 and args[0] is type(None):
+            return args[1]
+        if len(args) == 2 and args[1] is type(None):
+            return args[0]
+
+        return None
+
+    return source

decoy/spy_events.py

@@ -1,4 +1,5 @@
 """Spy interaction event value objects."""
+
 import enum
 from typing import Any, Dict, NamedTuple, Optional, Tuple, Union
 

decoy/spy_log.py

@@ -1,4 +1,5 @@
 """Spy activity log."""
+
 from typing import List, Sequence
 
 from .errors import MissingRehearsalError

decoy/stringify.py

@@ -1,4 +1,5 @@
 """Message string generation."""
+
 import os
 from typing import Sequence
 

decoy/stub_store.py

@@ -1,4 +1,5 @@
 """Stub creation and storage."""
+
 from typing import Any, Callable, List, NamedTuple, Optional, Union
 
 from .spy_events import SpyEvent, WhenRehearsal, match_event

decoy/types.py

@@ -1,4 +1,5 @@
 """Common type definitions."""
+
 from typing import Any, Callable, TypeVar
 
 FuncT = TypeVar("FuncT", bound=Callable[..., Any])

decoy/verifier.py

@@ -1,4 +1,5 @@
 """Spy call verification."""
+
 from typing import Optional, Sequence
 
 from .spy_events import SpyEvent, VerifyRehearsal, match_event

decoy/warning_checker.py

@@ -1,4 +1,5 @@
 """Warning checker."""
+
 from collections import defaultdict
 from itertools import groupby
 from typing import Dict, List, NamedTuple, Sequence

decoy/warnings.py

@@ -4,6 +4,7 @@ See the [warnings guide][] for more details.
 
 [warnings guide]: usage/errors-and-warnings.md#warnings
 """
+
 import os
 from typing import Sequence
 
@@ -95,13 +96,3 @@ class IncorrectCallWarning(DecoyWarning):
 
     [IncorrectCallWarning guide]: usage/errors-and-warnings.md#incorrectcallwarning
     """
-
-
-class MissingSpecAttributeWarning(DecoyWarning):
-    """A warning raised if a Decoy mock with a spec is used with a missing attribute.
-
-    This will become an error in the next major version of Decoy.
-    See the [MissingSpecAttributeWarning guide][] for more details.
-
-    [MissingSpecAttributeWarning guide]: usage/errors-and-warnings.md#missingspecattributewarning
-    """

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

@@ -1,8 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: decoy
-Version: 2.1.1
+Version: 2.2.0
 Summary: Opinionated mocking library for Python
-Home-page: https://michael.cousins.io/decoy/
 License: MIT
 Author: Michael Cousins
 Author-email: michael@cousins.io
@@ -18,11 +17,13 @@ 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: Repository, https://github.com/mcous/decoy
 Description-Content-Type: text/markdown
 

decoy-2.2.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+decoy/__init__.py,sha256=wGgiPaajcP3DgnFQZi_6aRiCvrx-rZNNH7hgcu6Zx0Q,11225
+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/mypy/__init__.py,sha256=GdJCf-gXpYB4SBr-Rm8zCLZQxAUuLjPyUieIWgLmdwA,86
+decoy/mypy/plugin.py,sha256=nCfo4XpDxBRDsInDsvCe6h8t7-1OV0ZCJzIJqTsAU0I,1359
+decoy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+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/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-2.1.1.dist-info → decoy-2.2.0.dist-info}/WHEEL

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

decoy-2.1.1.dist-info/RECORD

@@ -1,25 +0,0 @@
-decoy/__init__.py,sha256=vwNdsTHo61z4UQH3U4hiy6ECb9mKK9pUfNGEzxnAwn8,11280
-decoy/call_handler.py,sha256=vbqY_N6UWIRdwoOljEzl7y5iTDiFC-zxHfzl8ykuhxU,1511
-decoy/context_managers.py,sha256=-Zmqtd_kZESZpLrBSxgOSofH6scgsOwcqPATFb49LWM,1286
-decoy/core.py,sha256=4zQTVa3f8UNqwb6VQOGR1IDOSdvNOWIKuemmqPb5P1M,5829
-decoy/errors.py,sha256=F-8T_e_xDVcuVaGYJG1Bdc0RRVGQFyBtH-A4eMW_AYQ,2888
-decoy/matchers.py,sha256=zTYmT7gPuMa2UZDeMdaukmanWRDuwWDm94_5Mq9txFg,9963
-decoy/mypy/__init__.py,sha256=_Va3O7r0QoniZAD3IaRWo2DHt1OF0o5vgR9gmr48U3s,85
-decoy/mypy/plugin.py,sha256=LLJCfYQdEEayym0S6Re3BZG4gdi3drmyoIjiFXasfw0,1358
-decoy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-decoy/pytest_plugin.py,sha256=bPJ9v8cwEFxtPQRWeTuP97WsWsaWHaXPPVKxiFf3VyE,852
-decoy/spy.py,sha256=kpPXruiWcGwu8jOlIU4HWjaJUiSEzZ_AFc19eFevOhc,7596
-decoy/spy_core.py,sha256=71O8DajiD1W1sIlyxQiG0D3SwSDShpMMgh5sZ4M6QS8,7519
-decoy/spy_events.py,sha256=paDLR_Pdn9KDemSOFRvHcDSidt-yzjX7sidXE8S67z8,2382
-decoy/spy_log.py,sha256=cgl4inDJ-bpAiwuGbkWKWRaOGlGPTN8DKv1LiDJVbd4,3886
-decoy/stringify.py,sha256=-xlYGfYfjHJuAATmH9dQk7kIQbiBknzZ07GOzO4p7yU,2239
-decoy/stub_store.py,sha256=lLJGqv1CIxZlJFHhnXuoQdbp_q524eT-e8QHEDPSAew,1743
-decoy/types.py,sha256=y2DYDekkGzjKTshW0VN3Yw6pifb5T9AyqdrpwohKV3A,403
-decoy/verifier.py,sha256=FK_HmJnNSqwkkCAlkeZVtb2sK0sUZEwhnlP42dgXN4Y,1578
-decoy/warning_checker.py,sha256=NVA4KwPeM7vneTku60XiDGjD9tG_ywkz6R7WvmTAlQA,3526
-decoy/warnings.py,sha256=kPRR0ujdNGS_W_ciNvR5dGWyQuuWbooZduPW6OB32t8,3347
-decoy-2.1.1.dist-info/LICENSE,sha256=Rxi19kHgqakAsJNG1jMuORmgKx9bI8Pcu_gtzFkhflQ,1078
-decoy-2.1.1.dist-info/METADATA,sha256=Sp1N8SINWUxIVYtSbczbrZIsPRksBjTjhqsHWSX33Y4,7157
-decoy-2.1.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-decoy-2.1.1.dist-info/entry_points.txt,sha256=P2wF8zdthEM-3Yo32kxHDhZDjbW6AE489HPWqnvPLOU,38
-decoy-2.1.1.dist-info/RECORD,,