wrapture 1.0.0.dev6__tar.gz → 1.0.0.dev7__tar.gz

{wrapture-1.0.0.dev6/src/wrapture.egg-info → wrapture-1.0.0.dev7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wrapture
-Version: 1.0.0.dev6
+Version: 1.0.0.dev7
 Summary: Monkey patch, test, and trace Python by attaching bindings to call sites, without modifying the code being observed. Built on wrapt.
 Author-email: Graham Dumpleton <Graham.Dumpleton@gmail.com>
 License-Expression: BSD-2-Clause
@@ -31,7 +31,7 @@ Dynamic: license-file
 
 # wrapture
 
-**Trace assertions without instrumenting your code.**
+**Wrap anything, capture everything, change nothing.**
 
 [![Tests](https://github.com/GrahamDumpleton/wrapture/actions/workflows/build-test-release.yml/badge.svg?branch=develop)](https://github.com/GrahamDumpleton/wrapture/actions/workflows/build-test-release.yml)
 [![Documentation](https://readthedocs.org/projects/wrapture/badge/?version=latest)](https://wrapture.readthedocs.io)
@@ -166,6 +166,13 @@ testing assertion library, a tracing tool, or both at once.
 - Python 3.12+
 - [wrapt](https://github.com/GrahamDumpleton/wrapt) 2.4.0+
 
+## Issues
+
+Bug reports and feature requests go to the
+[issue tracker](https://github.com/GrahamDumpleton/wrapture/issues).
+Include the wrapture and Python versions and, where you can, a small
+binding that reproduces the problem.
+
 ## License
 
 BSD 2-Clause. See

{wrapture-1.0.0.dev6 → wrapture-1.0.0.dev7}/README.md

@@ -1,6 +1,6 @@
 # wrapture
 
-**Trace assertions without instrumenting your code.**
+**Wrap anything, capture everything, change nothing.**
 
 [![Tests](https://github.com/GrahamDumpleton/wrapture/actions/workflows/build-test-release.yml/badge.svg?branch=develop)](https://github.com/GrahamDumpleton/wrapture/actions/workflows/build-test-release.yml)
 [![Documentation](https://readthedocs.org/projects/wrapture/badge/?version=latest)](https://wrapture.readthedocs.io)
@@ -135,6 +135,13 @@ testing assertion library, a tracing tool, or both at once.
 - Python 3.12+
 - [wrapt](https://github.com/GrahamDumpleton/wrapt) 2.4.0+
 
+## Issues
+
+Bug reports and feature requests go to the
+[issue tracker](https://github.com/GrahamDumpleton/wrapture/issues).
+Include the wrapture and Python versions and, where you can, a small
+binding that reproduces the problem.
+
 ## License
 
 BSD 2-Clause. See

{wrapture-1.0.0.dev6 → wrapture-1.0.0.dev7}/src/wrapture/__init__.py

@@ -17,10 +17,10 @@ def _format_version(parts: tuple[str, ...]) -> str:
     )
 
 
-__version_info__ = ("1", "0", "0", "dev6")
+__version_info__ = ("1", "0", "0", "dev7")
 __version__ = _format_version(__version_info__)
 
-from wrapt import MISSING
+from wrapt import MISSING, register_post_import_hook, when_imported
 
 from .asgi import (
     ASGIMiddleware,
@@ -131,6 +131,8 @@ from .wsgi import (
 
 __all__ = [
     "MISSING",
+    "register_post_import_hook",
+    "when_imported",
     "ASGIMiddleware",
     "Aggregate",
     "AlreadyAppliedError",

{wrapture-1.0.0.dev6 → wrapture-1.0.0.dev7}/src/wrapture/bindings.py

@@ -135,7 +135,8 @@ def _reject_deferred(target: Any) -> None:
             f" wrapt's trailing `?` syntax. A deferred wrap registers a"
             f" post-import hook and returns no handle, so a binding would"
             f" have nothing to remove, suspend or query. Import the module"
-            f" first and bind against it."
+            f" first and bind against it, or create the binding inside a"
+            f" `wrapture.when_imported` hook for that module."
         )
 
 

{wrapture-1.0.0.dev6 → wrapture-1.0.0.dev7}/src/wrapture/exceptions.py

@@ -48,7 +48,8 @@ class NotImplementedYetError(NotImplementedError):
 
 class DeferredTargetError(ValueError):
     """A string target used wrapt's trailing `?` deferred-patching syntax,
-    which is not supported. Import the module first and bind against it.
+    which is not supported. Import the module first and bind against it,
+    or create the binding inside a `wrapture.when_imported` hook.
     """
 
 

{wrapture-1.0.0.dev6 → wrapture-1.0.0.dev7/src/wrapture.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wrapture
-Version: 1.0.0.dev6
+Version: 1.0.0.dev7
 Summary: Monkey patch, test, and trace Python by attaching bindings to call sites, without modifying the code being observed. Built on wrapt.
 Author-email: Graham Dumpleton <Graham.Dumpleton@gmail.com>
 License-Expression: BSD-2-Clause
@@ -31,7 +31,7 @@ Dynamic: license-file
 
 # wrapture
 
-**Trace assertions without instrumenting your code.**
+**Wrap anything, capture everything, change nothing.**
 
 [![Tests](https://github.com/GrahamDumpleton/wrapture/actions/workflows/build-test-release.yml/badge.svg?branch=develop)](https://github.com/GrahamDumpleton/wrapture/actions/workflows/build-test-release.yml)
 [![Documentation](https://readthedocs.org/projects/wrapture/badge/?version=latest)](https://wrapture.readthedocs.io)
@@ -166,6 +166,13 @@ testing assertion library, a tracing tool, or both at once.
 - Python 3.12+
 - [wrapt](https://github.com/GrahamDumpleton/wrapt) 2.4.0+
 
+## Issues
+
+Bug reports and feature requests go to the
+[issue tracker](https://github.com/GrahamDumpleton/wrapture/issues).
+Include the wrapture and Python versions and, where you can, a small
+binding that reproduces the problem.
+
 ## License
 
 BSD 2-Clause. See

{wrapture-1.0.0.dev6 → wrapture-1.0.0.dev7}/tests/test_bindings.py

@@ -250,6 +250,24 @@ def test_deferred_target_error_is_a_value_error() -> None:
     assert issubclass(DeferredTargetError, ValueError)
 
 
+def test_deferred_target_error_points_at_when_imported() -> None:
+    with pytest.raises(DeferredTargetError, match="wrapture.when_imported"):
+        binding("mymodule?", "handler")
+
+
+def test_post_import_hook_helpers_are_reexported_from_wrapt() -> None:
+    # The supported route to patching a module before it is imported is
+    # a post-import hook, so wrapt's helpers are available under the
+    # wrapture name to save application code importing wrapt for them.
+
+    import wrapture
+
+    assert wrapture.when_imported is wrapt.when_imported
+    assert wrapture.register_post_import_hook is wrapt.register_post_import_hook
+    assert "when_imported" in wrapture.__all__
+    assert "register_post_import_hook" in wrapture.__all__
+
+
 # ---------------------------------------------------------------------------
 # modes and behaviour namespaces
 # ---------------------------------------------------------------------------