wrapture 1.0.0.dev6__tar.gz → 1.0.0.dev8__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wrapture
-Version: 1.0.0.dev6
+Version: 1.0.0.dev8
 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)
@@ -44,10 +44,10 @@ It is a sibling project to [wrapt](https://github.com/GrahamDumpleton/wrapt)
 and [autowrapt](https://github.com/GrahamDumpleton/autowrapt), building on the
 safe monkey-patching machinery wrapt provides.
 
-> **Status: early development.** The monkey patching, unit testing and
-> ad-hoc tracing layers are implemented, including WSGI and ASGI request
-> tracing. Development previews are published to PyPI; the API may still
-> shift before 1.0.0.
+> **Status: stabilising ahead of 1.0.0.** The feature set is complete for
+> a first release and development previews are published to PyPI. The API
+> is being exercised and tidied rather than extended, so small changes are
+> still possible before 1.0.0.
 
 ## Installation
 
@@ -112,8 +112,8 @@ One mechanism, three uses, in increasing order of machinery:
 
 2. **Unit testing.** Observe and assert on how calls actually flowed through a
    *real* call graph (nesting, ordering, arguments and return values) and
-   optionally intervene (stub, transform, fail-inject). Unlike a `Mock`,
-   which fabricates values and cannot see calls an object makes to itself,
+   optionally intervene (stub, transform, fail-inject). Unlike a
+   `unittest.mock` `Mock`, which fabricates values and cannot see calls an object makes to itself,
    wrapture watches the real code run. This makes it possible to test code
    with no injectable seams at all, and to assert on what *didn't* happen on
    an error path: inject a gateway timeout, then verify the ledger was not
@@ -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.dev8}/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)
@@ -13,10 +13,10 @@ It is a sibling project to [wrapt](https://github.com/GrahamDumpleton/wrapt)
 and [autowrapt](https://github.com/GrahamDumpleton/autowrapt), building on the
 safe monkey-patching machinery wrapt provides.
 
-> **Status: early development.** The monkey patching, unit testing and
-> ad-hoc tracing layers are implemented, including WSGI and ASGI request
-> tracing. Development previews are published to PyPI; the API may still
-> shift before 1.0.0.
+> **Status: stabilising ahead of 1.0.0.** The feature set is complete for
+> a first release and development previews are published to PyPI. The API
+> is being exercised and tidied rather than extended, so small changes are
+> still possible before 1.0.0.
 
 ## Installation
 
@@ -81,8 +81,8 @@ One mechanism, three uses, in increasing order of machinery:
 
 2. **Unit testing.** Observe and assert on how calls actually flowed through a
    *real* call graph (nesting, ordering, arguments and return values) and
-   optionally intervene (stub, transform, fail-inject). Unlike a `Mock`,
-   which fabricates values and cannot see calls an object makes to itself,
+   optionally intervene (stub, transform, fail-inject). Unlike a
+   `unittest.mock` `Mock`, which fabricates values and cannot see calls an object makes to itself,
    wrapture watches the real code run. This makes it possible to test code
    with no injectable seams at all, and to assert on what *didn't* happen on
    an error path: inject a gateway timeout, then verify the ledger was not
@@ -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.dev8}/src/wrapture/__init__.py

@@ -17,19 +17,23 @@ def _format_version(parts: tuple[str, ...]) -> str:
     )
 
 
-__version_info__ = ("1", "0", "0", "dev6")
+__version_info__ = ("1", "0", "0", "dev8")
 __version__ = _format_version(__version_info__)
 
-from wrapt import MISSING
+from wrapt import MISSING, register_post_import_hook, when_imported
 
 from .asgi import (
     ASGIMiddleware,
 )
 from .behaviours import (
     CallBehaviour,
+    CallPhase,
     DeleteBehaviour,
+    DeletePhase,
     GetBehaviour,
+    GetPhase,
     SetBehaviour,
+    SetPhase,
 )
 from .bindings import (
     Binding,
@@ -69,6 +73,7 @@ from .exceptions import (
     NeverAppliedError,
     NotImplementedYetError,
     RecordingGapWarning,
+    SequenceExhaustedError,
     SinkErrorWarning,
     WrongModeError,
 )
@@ -131,6 +136,8 @@ from .wsgi import (
 
 __all__ = [
     "MISSING",
+    "register_post_import_hook",
+    "when_imported",
     "ASGIMiddleware",
     "Aggregate",
     "AlreadyAppliedError",
@@ -142,12 +149,14 @@ __all__ = [
     "Window",
     "BindingGroup",
     "CallBehaviour",
+    "CallPhase",
     "Config",
     "ConfigError",
     "ConfigWarning",
     "Counter",
     "DeferredTargetError",
     "DeleteBehaviour",
+    "DeletePhase",
     "Depth",
     "Event",
     "EventLog",
@@ -155,6 +164,7 @@ __all__ = [
     "Fanout",
     "Filter",
     "GetBehaviour",
+    "GetPhase",
     "IteratorAbandonBehaviour",
     "IteratorErrorBehaviour",
     "IteratorFinishBehaviour",
@@ -169,7 +179,9 @@ __all__ = [
     "Printer",
     "RecordingGapWarning",
     "Sample",
+    "SequenceExhaustedError",
     "SetBehaviour",
+    "SetPhase",
     "SetupEntry",
     "Sink",
     "SinkErrorWarning",