decoy 2.4.0__tar.gz → 2.5.0__tar.gz

{decoy-2.4.0 → decoy-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: decoy
-Version: 2.4.0
+Version: 2.5.0
 Summary: Opinionated mocking library for Python
 Author: Michael Cousins
 Author-email: Michael Cousins <michael@cousins.io>>

decoy-2.5.0/decoy/pytest_plugin.py

@@ -0,0 +1,58 @@
+"""Pytest plugin to setup and teardown a Decoy instance.
+
+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 TYPE_CHECKING, Iterable, Union, get_type_hints
+
+import pytest
+
+from decoy import Decoy
+
+if TYPE_CHECKING:
+    from decoy.next import Decoy as DecoyNext
+
+
+@pytest.fixture()
+def decoy(
+    request: pytest.FixtureRequest,
+) -> "Iterable[Union[Decoy, DecoyNext]]":
+    """Get a [decoy.Decoy][] container and [reset it][decoy.Decoy.reset] after the test.
+
+    This function is function-scoped [pytest fixture][] that will be
+    automatically inserted by the plugin.
+
+    !!! tip
+
+        This fixture will automatically opt-into the [v3 preview API][v3-preview]
+        if annotated with `decoy.next.Decoy`.
+
+    [pytest fixture]: https://docs.pytest.org/en/latest/how-to/fixtures.html
+    [v3-preview]: ./v3/about.md
+
+    !!! example
+        ```python
+        def test_my_thing(decoy: Decoy) -> None:
+            my_fake_func = decoy.mock()
+            # ...
+        ```
+    """
+    try:
+        decoy_hint = get_type_hints(request.function).get("decoy")
+        is_next = decoy_hint.__module__.startswith("decoy.next")
+
+    # purely defensive, probably won't ever raise
+    except Exception:  # pragma: no cover
+        is_next = False
+
+    if is_next:
+        from decoy.next import Decoy as DecoyNext
+
+        with DecoyNext.create() as decoy_next:
+            yield decoy_next
+    else:
+        decoy = Decoy()
+        yield decoy
+        decoy.reset()

{decoy-2.4.0 → decoy-2.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "decoy"
-version = "2.4.0"
+version = "2.5.0"
 description = "Opinionated mocking library for Python"
 readme = "README.md"
 license = "MIT"
@@ -77,11 +77,13 @@ test = "pytest -f"
 test-once = "coverage run --branch --source=decoy -m pytest --mypy-same-process"
 coverage = "coverage report"
 coverage-xml = "coverage xml"
+coverage-html = "coverage html"
 docs = "mkdocs serve --livereload"
 build-docs = "mkdocs build"
 build-package = "uv build"
 check-ci = ["check", "lint", "format-check"]
 test-ci = ["test-once", "coverage-xml"]
+test-coverage = ["test-once", "coverage-html", "coverage"]
 
 [tool.pytest.ini_options]
 addopts = "--color=yes --mypy-ini-file=tests/legacy/typing/mypy.ini --mypy-only-local-stub"

decoy-2.4.0/decoy/pytest_plugin.py

@@ -1,33 +0,0 @@
-"""Pytest plugin to setup and teardown a Decoy instance.
-
-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
-
-from decoy import Decoy
-
-
-@pytest.fixture()
-def decoy() -> Iterable[Decoy]:
-    """Get a [decoy.Decoy][] container and [reset it][decoy.Decoy.reset] after the test.
-
-    This function is function-scoped [pytest fixture][] that will be
-    automatically inserted by the plugin.
-
-    [pytest fixture]: https://docs.pytest.org/en/latest/how-to/fixtures.html
-
-    !!! example
-        ```python
-        def test_my_thing(decoy: Decoy) -> None:
-            my_fake_func = decoy.mock()
-            # ...
-        ```
-    """
-    decoy = Decoy()
-    yield decoy
-    decoy.reset()