spot-sdk-python 2.1.0b2__py3-none-any.whl → 2.1.1__py3-none-any.whl

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/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.

{spot_sdk_python-2.1.0b2.dist-info → spot_sdk_python-2.1.1.dist-info}/METADATA

@@ -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.dist-info → spot_sdk_python-2.1.1.dist-info}/RECORD

@@ -7,7 +7,7 @@ spot_sdk/config.py,sha256=sMSCOI_eVlcNiPamj4Nyuq7p44KZr06LFZVDlYgcqiI,1560
 spot_sdk/correlation.py,sha256=tgIL122V_d0htaR005zBHt2iLOoQnj3E-X-yKyPT6dc,2184
 spot_sdk/email.py,sha256=ifZHG9M0x-sTrOtohrU1NStsL4qeVddn18JoqLFawIQ,7313
 spot_sdk/errors.py,sha256=HTaRaoDfn5XV4v03qD4eCM-IgNaR7upQ08UF-I-1qaI,813
-spot_sdk/hosting.py,sha256=4Zb2bBmmrPelDSulNEJOub7V8cYUpVFjNZBWCIWumUo,5481
+spot_sdk/hosting.py,sha256=3yQl5xEiFlVAts065e-LT6-qsajxAVhQ4KetHHmYpNE,5836
 spot_sdk/knowledge.py,sha256=TiBFPTekknqPuOGcH4FnkEsYBc5zZkmW7ToZTfTstqc,12405
 spot_sdk/knowledge_tags.py,sha256=BGhDsNeF8Q0MMNEIZjWrgQWjwH_Vf7dGBNN_hlBqTXs,978
 spot_sdk/llm.py,sha256=IEWhBbEat-7oHSNDg9_QOb7ylzv2g0B9uACpZq9-vMk,18610
@@ -23,7 +23,7 @@ spot_sdk/settings.py,sha256=4FN8WYSEoxY-Gf4D0jaSU-5z6o0EqrQXFbnD03qhd0Q,2884
 spot_sdk/signals.py,sha256=DkTqCSCcGbbtJjoTFrXExY9TcKFDXb-4SLR8wAgJUx0,1517
 spot_sdk/testing/README.md,sha256=N-42IBZOCxf0KbrfZ0nO64eBEC-l2hlQAjq4qIRJLQU,2786
 spot_sdk/testing/__init__.py,sha256=4pTiWDdyYBFJwQnrhiC8PK8Ag-puKGEAHQG4hv8zfRs,555
-spot_sdk/testing/container.py,sha256=2n4NMLb7ONEbCpO0GAb8Tj8O7QPrNIq7-acRz-IGYaE,18530
+spot_sdk/testing/container.py,sha256=I4R-K-sWjT-AHPf-DoXacrBvLO-2fVqxPLwTgv0XofM,18504
 spot_sdk/testing/contract.py,sha256=t4J9HYIw2GF9esViY9362HYWoQunI3t9q6SraQhl0gA,10720
 spot_sdk/testing/corpus.py,sha256=O1tEjwOR2VHPI_kWelQmvFjUXs_0OUtUEFtKfpdighc,9240
 spot_sdk/testing/engine.py,sha256=IviyvQGvSGUiUSaK4Bbpv5O8sRs0LCpw49pXhR3kCZI,16280
@@ -37,6 +37,6 @@ spot_sdk/testing/views.py,sha256=Su45wOqCQG_O2WcpZhFnCZCLEc8yd9KsUl3YkjvvM9g,164
 spot_sdk/urls.py,sha256=pAz5Zara9UkNRoN2Vtx-33pARfBDy3JIA8xi-bkFdmk,1637
 spot_sdk/verdict.py,sha256=FUtAcsajJKgO_LaAfEJtHYq1K9BwG7a6sfpVkITjs_w,4429
 spot_sdk/workflow.py,sha256=sxD_Ms-t8Emv2vn4vf7ftJRIsPR9Fy7LumwFji60LP0,6993
-spot_sdk_python-2.1.0b2.dist-info/WHEEL,sha256=rp-k_VZaX8oABFEtLwG_Df95p8LSKt9-uPyQ4jKH0P4,81
-spot_sdk_python-2.1.0b2.dist-info/METADATA,sha256=nKguIZfBOVLkWplqSAOHF4bAVZALyDDpcr1jiY6zQ8k,4078
-spot_sdk_python-2.1.0b2.dist-info/RECORD,,
+spot_sdk_python-2.1.1.dist-info/WHEEL,sha256=rp-k_VZaX8oABFEtLwG_Df95p8LSKt9-uPyQ4jKH0P4,81
+spot_sdk_python-2.1.1.dist-info/METADATA,sha256=9IdM1c1gi71oI5OEBll8YkkOS47u8qtUXV7E47oyjRs,4076
+spot_sdk_python-2.1.1.dist-info/RECORD,,