spot-sdk-python 2.1.0b2__tar.gz → 2.1.1__tar.gz

{spot_sdk_python-2.1.0b2 → spot_sdk_python-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spot-sdk-python
-Version: 2.1.0b2
+Version: 2.1.1
 Summary: SPOT plugin SDK: the plugin contract, the plugin runtime, its clients and test helpers
 Author: SPOT Project
 Author-email: SPOT Project <spot@sonn.lu>

{spot_sdk_python-2.1.0b2 → spot_sdk_python-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "spot-sdk-python"
-version = "2.1.0b2"
+version = "2.1.1"
 description = "SPOT plugin SDK: the plugin contract, the plugin runtime, its clients and test helpers"
 readme = "README.md"
 license = "Apache-2.0"

{spot_sdk_python-2.1.0b2 → spot_sdk_python-2.1.1}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "spot-sdk-python"
-version = "2.1.0b2"
+version = "2.1.1"
 description = "SPOT plugin SDK: the plugin contract, the plugin runtime, its clients and test helpers"
 readme = "README.md"
 license = "Apache-2.0"

{spot_sdk_python-2.1.0b2 → spot_sdk_python-2.1.1}/spot_sdk/hosting.py

@@ -44,7 +44,11 @@ could expand past the bound once decoded."""
 
 
 class AnswerRefusedError(Exception):
-    """A plugin's answer that is not read: encoded, or longer than ``MAX_ANSWER_BYTES``."""
+    """A plugin's answer that is not read: encoded, or longer than its bound."""
+
+
+class AnswerTooLargeError(AnswerRefusedError):
+    """An answer longer than its bound, which a caller may treat apart from an encoded one."""
 
 
 class InvalidResponseError(Exception):
@@ -53,8 +57,10 @@ class InvalidResponseError(Exception):
 
 def isolated(egress: Egress | None) -> bool:
     """Whether a plugin of this egress class runs on a network without a route
-    out: class none. An unrecorded class (None) counts as content."""
-    return egress == Egress.NONE
+    out: every class, from SPOT 2.1 (spot/spot#148). A plugin reaches the
+    hosts its settings of type url name, through SPOT's egress gateway, and
+    nothing else: its class says what it sends out, not where it runs."""
+    return True
 
 
 def limits(resources: Resources) -> dict[str, Any]:
@@ -119,11 +125,14 @@ def secrets_archive(secrets: Mapping[str, str]) -> bytes:
     return buffer.getvalue()
 
 
-async def read_answer(response: httpx2.Response) -> bytes:
-    """A streamed answer's body, as sent, read up to ``MAX_ANSWER_BYTES``.
+async def read_answer(
+    response: httpx2.Response, max_bytes: int = MAX_ANSWER_BYTES
+) -> bytes:
+    """A streamed answer's body, as sent, read up to ``max_bytes``.
 
     Raises:
-        AnswerRefusedError: the answer is encoded, or longer than ``MAX_ANSWER_BYTES``
+        AnswerRefusedError: the answer is encoded
+        AnswerTooLargeError: the answer is longer than ``max_bytes``
     """
     if (
         response.headers.get("content-encoding", "identity").strip().lower()
@@ -133,8 +142,8 @@ async def read_answer(response: httpx2.Response) -> bytes:
     body = bytearray()
     async for chunk in response.aiter_raw():
         body += chunk
-        if len(body) > MAX_ANSWER_BYTES:
-            raise AnswerRefusedError("response too large")
+        if len(body) > max_bytes:
+            raise AnswerTooLargeError(f"response too large: over {max_bytes} bytes")
     return bytes(body)
 
 

{spot_sdk_python-2.1.0b2 → spot_sdk_python-2.1.1}/spot_sdk/testing/container.py

@@ -1,14 +1,14 @@
 """A plugin's image run as SPOT runs it, and checked: ``run_plugin_test``.
 
 The engine runs in a container that reaches the Docker daemon: spot-cli's
-image, given the socket. For each run it creates a network, without a route
-out for a plugin of egress class none as ``spot-plugins-isolated`` is, and
-joins it under SPOT's names, so that the plugin reaches the fake SPOT where it
-reaches SPOT. The plugin's container gets the plugin-manager's options and
-limits, a new token and its secret settings as files (``spot_sdk.hosting``).
-The network and the container carry the label ``spot.test.run=<run>``, by
-which the run removes them when it ends, however it ends: even one the daemon
-made while the call that asked for it failed. The image is never pulled.
+image, given the socket. For each run it creates a network without a route
+out, as SPOT runs every plugin (``isolated``), and joins it under SPOT's
+names, so that the plugin reaches the fake SPOT where it reaches SPOT. The
+plugin's container gets the plugin-manager's options and limits, a new token
+and its secret settings as files (``spot_sdk.hosting``). The network and the
+container carry the label ``spot.test.run=<run>``, by which the run removes
+them when it ends, however it ends: even one the daemon made while the call
+that asked for it failed. The image is never pulled.
 Needs the ``testing`` extra: ``pip install "spot-sdk-python[testing]"``.
 """
 
@@ -93,8 +93,8 @@ def run_plugin_test(
     """Run the plugin's image as SPOT runs it, against ``corpus``, and report.
 
     It runs in a container that reaches the Docker daemon: spot-cli's image,
-    given the socket. It creates the plugin's network (internal for egress
-    class none), joins it as SPOT's services, starts the plugin with the
+    given the socket. It creates the plugin's network (internal, as for every
+    plugin), joins it as SPOT's services, starts the plugin with the
     plugin-manager's options, its limits, a new token and its secrets as
     files, serves the fake SPOT, runs the checks and removes what it
     created, whatever happens.