dirigent-testing 0.20.0__tar.gz → 0.21.0__tar.gz

{dirigent_testing-0.20.0 → dirigent_testing-0.21.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: dirigent-testing
-Version: 0.20.0
+Version: 0.21.0
 Summary: Test doubles and pytest fixtures for writing and testing dirigent blocks.
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: dirigent-common==0.20.0
-Requires-Dist: dirigent-plugin==0.20.0
+Requires-Dist: dirigent-common==0.21.0
+Requires-Dist: dirigent-plugin==0.21.0
 Requires-Dist: httpx2>=2.12.0
 Requires-Dist: pydantic>=2.13.5
 Requires-Dist: pytest>=9.1.1

{dirigent_testing-0.20.0 → dirigent_testing-0.21.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-testing"
-version = "0.20.0"
+version = "0.21.0"
 description = "Test doubles and pytest fixtures for writing and testing dirigent blocks."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,8 +11,8 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-common==0.20.0",
-    "dirigent-plugin==0.20.0",
+    "dirigent-common==0.21.0",
+    "dirigent-plugin==0.21.0",
     "httpx2>=2.12.0",
     "pydantic>=2.13.5",
     "pytest>=9.1.1",

{dirigent_testing-0.20.0 → dirigent_testing-0.21.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-testing"
-version = "0.20.0"
+version = "0.21.0"
 description = "Test doubles and pytest fixtures for writing and testing dirigent blocks."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,8 +11,8 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-common==0.20.0",
-    "dirigent-plugin==0.20.0",
+    "dirigent-common==0.21.0",
+    "dirigent-plugin==0.21.0",
     "httpx2>=2.12.0",
     "pydantic>=2.13.5",
     "pytest>=9.1.1",

{dirigent_testing-0.20.0 → dirigent_testing-0.21.0}/src/dirigent_testing/__init__.py

@@ -4,7 +4,7 @@ from dirigent_testing.conformance import assert_contribution_conforms, check_pac
 from dirigent_testing.doubles import FakeCapture, FakeContext, FakeRuns, FakeSink, FakeStorage, RecordingLogger
 from dirigent_testing.environment import CONFIGURING_PREFIXES, TEST_WIDTH, pin_terminal, scrub_configuration
 from dirigent_testing.fixtures import no_connection_outlives_its_loop
-from dirigent_testing.running import call_block
+from dirigent_testing.running import call_block, carry_cursor
 
 __all__ = [
     "CONFIGURING_PREFIXES",
@@ -17,6 +17,7 @@ __all__ = [
     "RecordingLogger",
     "assert_contribution_conforms",
     "call_block",
+    "carry_cursor",
     "check_pack_examples",
     "no_connection_outlives_its_loop",
     "pin_terminal",

{dirigent_testing-0.20.0 → dirigent_testing-0.21.0}/src/dirigent_testing/doubles.py

@@ -226,7 +226,7 @@ class FakeContext:
         self.started_at = datetime.now(UTC)
         self.inline_capture = 8 * 1024
         self.cursor: dict[str, JsonValue] | None = None
-        """What the last committed ``NotYet`` returned, which a test sets to poke again."""
+        """What the next poke is handed: set by a test, or by ``carry_cursor`` as the engine would."""
         self.params: dict[str, JsonValue] = {}
         self.log = RecordingLogger()
         self.connections: dict[str, BaseModel] = {}

{dirigent_testing-0.20.0 → dirigent_testing-0.21.0}/src/dirigent_testing/running.py

@@ -5,7 +5,7 @@ from typing import Any
 
 from pydantic import BaseModel
 
-from dirigent_plugin import AnyOperator, AnySensor, Operator, StepContext
+from dirigent_plugin import AnyOperator, AnySensor, NotYet, Operator, StepContext
 from dirigent_testing.doubles import FakeContext
 
 
@@ -25,3 +25,18 @@ async def call_block(
     if isinstance(block, Operator):
         return await block.execute(validated, context)
     return await block.poke(validated, context)
+
+
+def carry_cursor(sensor: AnySensor, answer: BaseModel, ctx: FakeContext) -> None:
+    """Hand the next poke the cursor the engine would, after one poke answered this.
+
+    A park that returned a cursor replaces the one the context held, and one that returned
+    none leaves it. A success hands on what :meth:`Sensor.resume_cursor` says, as a watch
+    hands it to the first poke of its next run.
+    """
+    if isinstance(answer, NotYet):
+        if answer.cursor is not None:
+            ctx.cursor = dict(answer.cursor)
+        return
+    resumed = sensor.resume_cursor(answer)
+    ctx.cursor = dict(resumed) if resumed is not None else None