decoy 2.1.0__py3-none-any.whl → 2.1.2__py3-none-any.whl

decoy/spy_core.py

@@ -2,7 +2,17 @@
 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
@@ -112,12 +122,15 @@ class SpyCore:
         source = self._source
         child_name = f"{self._name}.{name}"
         child_source = None
+        child_found = False
 
         if inspect.isclass(source):
             # use type hints to get child spec for class attributes
             child_hint = _get_type_hints(source).get(name)
             # use inspect to get child spec for methods and properties
             child_source = inspect.getattr_static(source, name, child_hint)
+            # record whether a child was found before we make modifications
+            child_found = child_source is not None
 
             if isinstance(child_source, property):
                 child_source = _get_type_hints(child_source.fget).get("return")
@@ -136,7 +149,9 @@ 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:
+        child_source = _unwrap_optional(child_source)
+
+        if source is not None and child_found is False:
             # stacklevel: 4 ensures warning is linked to call location
             warnings.warn(
                 MissingSpecAttributeWarning(f"{self._name} has no attribute '{name}'"),
@@ -215,3 +230,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/warnings.py

@@ -79,7 +79,7 @@ class RedundantVerifyWarning(DecoyWarning):
                 "The same rehearsal was used in both a `when` and a `verify`.",
                 "This is redundant and probably a misuse of the mock.",
                 f"\t{stringify_call(rehearsal)}",
-                "See https://mike.cousins.io/decoy/usage/errors-and-warnings/#redundantverifywarning",
+                "See https://michael.cousins.io/decoy/usage/errors-and-warnings/#redundantverifywarning",
             ]
         )
         super().__init__(message)

{decoy-2.1.0.dist-info → decoy-2.1.2.dist-info}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2023, Mike Cousins
+Copyright (c) 2020-2023, Michael Cousins
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{decoy-2.1.0.dist-info → decoy-2.1.2.dist-info}/METADATA

@@ -1,11 +1,10 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: decoy
-Version: 2.1.0
+Version: 2.1.2
 Summary: Opinionated mocking library for Python
-Home-page: https://mike.cousins.io/decoy/
 License: MIT
-Author: Mike Cousins
-Author-email: mike@cousins.io
+Author: Michael Cousins
+Author-email: michael@cousins.io
 Requires-Python: >=3.7,<4.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -17,16 +16,19 @@ 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://mike.cousins.io/decoy/
+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
 
 <div align="center">
-    <img alt="Decoy logo" src="https://mike.cousins.io/decoy/img/decoy.png" width="256px">
+    <img alt="Decoy logo" src="https://michael.cousins.io/decoy/img/decoy.png" width="256px">
     <h1 class="decoy-title">Decoy</h1>
     <p>Opinionated mocking library for Python</p>
     <p>
@@ -38,7 +40,7 @@ Description-Content-Type: text/markdown
         <a title="Supported Python Versions" href="https://pypi.org/project/decoy/"><img src="https://img.shields.io/pypi/pyversions/decoy?style=flat-square"></a>
     </p>
     <p>
-        <a href="https://mike.cousins.io/decoy/" class="decoy-hidden">Usage guide and documentation</a>
+        <a href="https://michael.cousins.io/decoy/" class="decoy-hidden">Usage guide and documentation</a>
     </p>
 </div>
 
@@ -86,8 +88,8 @@ plugins = decoy.mypy
 
 Decoy works well with [pytest][], but if you use another testing library or framework, you can still use Decoy! You just need to do two things:
 
-1. Create a new instance of [`Decoy()`](https://mike.cousins.io/decoy/api/#decoy.Decoy) before each test
-2. Call [`decoy.reset()`](https://mike.cousins.io/decoy/api/#decoy.Decoy.reset) after each test
+1. Create a new instance of [`Decoy()`](https://michael.cousins.io/decoy/api/#decoy.Decoy) before each test
+2. Call [`decoy.reset()`](https://michael.cousins.io/decoy/api/#decoy.Decoy.reset) after each test
 
 For example, using the built-in [unittest][] framework, you would use the `setUp` fixture method to do `self.decoy = Decoy()` and the `tearDown` method to call `self.decoy.reset()`. For a working example, see [`tests/test_unittest.py`](https://github.com/mcous/decoy/blob/main/tests/test_unittest.py).
 
@@ -171,9 +173,9 @@ See [spying with verify][] for more details.
 [unittest]: https://docs.python.org/3/library/unittest.html
 [typing]: https://docs.python.org/3/library/typing.html
 [mypy]: https://mypy.readthedocs.io/
-[api reference]: https://mike.cousins.io/decoy/api/
-[usage guide]: https://mike.cousins.io/decoy/usage/create/
-[creating mocks]: https://mike.cousins.io/decoy/usage/create/
-[stubbing with when]: https://mike.cousins.io/decoy/usage/when/
-[spying with verify]: https://mike.cousins.io/decoy/usage/verify/
+[api reference]: https://michael.cousins.io/decoy/api/
+[usage guide]: https://michael.cousins.io/decoy/usage/create/
+[creating mocks]: https://michael.cousins.io/decoy/usage/create/
+[stubbing with when]: https://michael.cousins.io/decoy/usage/when/
+[spying with verify]: https://michael.cousins.io/decoy/usage/verify/
 

{decoy-2.1.0.dist-info → decoy-2.1.2.dist-info}/RECORD

@@ -9,7 +9,7 @@ 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_core.py,sha256=QrmS7q8ABo-pXabk55IXVot3TN_fMhaG5CUGNuk2mz8,8435
 decoy/spy_events.py,sha256=paDLR_Pdn9KDemSOFRvHcDSidt-yzjX7sidXE8S67z8,2382
 decoy/spy_log.py,sha256=cgl4inDJ-bpAiwuGbkWKWRaOGlGPTN8DKv1LiDJVbd4,3886
 decoy/stringify.py,sha256=-xlYGfYfjHJuAATmH9dQk7kIQbiBknzZ07GOzO4p7yU,2239
@@ -17,9 +17,9 @@ 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=PsIWtGbDDTSMjQTmNlNcXaStcvli_VhepsAeZoISV2k,3344
-decoy-2.1.0.dist-info/LICENSE,sha256=ht-RotWwc1sy3UJIAeJehNeFO0aW_0QsCaCL0-NTgsA,1075
-decoy-2.1.0.dist-info/METADATA,sha256=aFMQdZx2vlnD360is1P_K9Q8kDo4UszIRHgBES-hURg,7067
-decoy-2.1.0.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-decoy-2.1.0.dist-info/entry_points.txt,sha256=P2wF8zdthEM-3Yo32kxHDhZDjbW6AE489HPWqnvPLOU,38
-decoy-2.1.0.dist-info/RECORD,,
+decoy/warnings.py,sha256=kPRR0ujdNGS_W_ciNvR5dGWyQuuWbooZduPW6OB32t8,3347
+decoy-2.1.2.dist-info/LICENSE,sha256=Rxi19kHgqakAsJNG1jMuORmgKx9bI8Pcu_gtzFkhflQ,1078
+decoy-2.1.2.dist-info/METADATA,sha256=5qGNUFcf_B1Blly9uBnBQV_S3nemThdQobxh6dZudv0,7220
+decoy-2.1.2.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+decoy-2.1.2.dist-info/entry_points.txt,sha256=P2wF8zdthEM-3Yo32kxHDhZDjbW6AE489HPWqnvPLOU,38
+decoy-2.1.2.dist-info/RECORD,,

{decoy-2.1.0.dist-info → decoy-2.1.2.dist-info}/WHEEL

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