volcano-sdk-python 0.11.2__tar.gz → 0.11.3__tar.gz

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/.gitignore

@@ -9,3 +9,4 @@ build/
 dist/
 *.egg-info/
 reports/
+mutants/

volcano_sdk_python-0.11.3/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.11.3"
+}

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.11.3](https://github.com/Kong/volcano-sdk-python/compare/v0.11.2...v0.11.3) (2026-09-23)
+
+
+### Bug Fixes
+
+* **storage:** validate response boundaries and stream fallback ([5c5cafe](https://github.com/Kong/volcano-sdk-python/commit/5c5cafeb7817c1f9453daabc18a958b21097325e))
+
 ## [0.11.2](https://github.com/Kong/volcano-sdk-python/compare/v0.11.1...v0.11.2) (2026-09-23)
 
 

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: volcano-sdk-python
-Version: 0.11.2
+Version: 0.11.3
 Summary: Official Python SDK for Volcano
 Project-URL: Homepage, https://volcano.dev
 Project-URL: Repository, https://github.com/Kong/volcano-sdk-python
@@ -18,7 +18,7 @@ Requires-Python: >=3.11
 Requires-Dist: attrs>=26.1.0
 Requires-Dist: centrifuge-python<0.7.0,>=0.6.0
 Requires-Dist: httpx<0.29.0,>=0.28.1
-Requires-Dist: typing-extensions>=4.4.0
+Requires-Dist: typing-extensions>=4.10.0
 Provides-Extra: durable
 Requires-Dist: aws-durable-execution-sdk-python<3.0.0,>=2.0.0; extra == 'durable'
 Description-Content-Type: text/markdown

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/features/broadcast_pause.py

@@ -31,12 +31,12 @@ async def verify_broadcast_pause(world: ContractWorld) -> object:
         delivered.append(message)
         received.put_nowait(message)
 
-    subscriber.on("message", on_message)
+    _ = subscriber.on("message", on_message)
     baseline = {
         **world.realtime_message,
         "value": world.realtime_message["value"] + "-baseline",
     }
-    await _publish_and_receive(publisher, received, baseline)
+    _ = await _publish_and_receive(publisher, received, baseline)
     await subscriber.unsubscribe()
     delivered.clear()
     await publisher.send(

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/features/contract_support.py

@@ -116,12 +116,12 @@ def classify_status(status: int | None) -> str:
 
 class ContractWorld:
     def __init__(self, fixture: ContractFixture) -> None:
-        self.fixture = fixture
-        self.client = VolcanoClient(
+        self.fixture: ContractFixture = fixture
+        self.client: VolcanoClient = VolcanoClient(
             api_url=fixture["api_url"],
             anon_key=fixture["anon_key"],
         )
-        self.service_client = VolcanoClient(
+        self.service_client: VolcanoClient = VolcanoClient(
             api_url=fixture["api_url"],
             anon_key=fixture["anon_key"],
             service_key=fixture["service_key"],
@@ -129,11 +129,11 @@ class ContractWorld:
         # Reading or stopping an execution is owner-scoped, so its client
         # carries the project's own token as its session. Neither key above can
         # reach those routes.
-        self.owner_client = VolcanoClient(
+        self.owner_client: VolcanoClient = VolcanoClient(
             api_url=fixture["api_url"],
             anon_key=fixture["anon_key"],
         )
-        self.owner_client.auth.set_session(
+        _ = self.owner_client.auth.set_session(
             Session(
                 access_token=fixture["platform_token"],
                 refresh_token=OWNER_SESSION_PLACEHOLDER,
@@ -141,16 +141,20 @@ class ContractWorld:
             )
         )
         suffix = f"py-{os.getpid()}-{secrets.token_hex(5)}"
-        self.storage_path = f"{fixture['storage_path']}.{suffix}"
-        self.realtime_channel = f"{fixture['realtime_channel']}-{suffix}"
-        self.lock_key = f"{fixture['lock_key']}-{suffix}"
-        self.storage_bytes = f"volcano-sdk-contract-{suffix}".encode()
-        self.realtime_message = {
+        self.storage_path: str = f"{fixture['storage_path']}.{suffix}"
+        self.realtime_channel: str = f"{fixture['realtime_channel']}-{suffix}"
+        self.lock_key: str = f"{fixture['lock_key']}-{suffix}"
+        self.storage_bytes: bytes = f"volcano-sdk-contract-{suffix}".encode()
+        self.realtime_message: dict[str, str] = {
             "event": "message",
             "value": f"volcano-sdk-contract-{suffix}",
         }
-        self.durable_execution_name = f"{fixture['durable_function_name']}-{suffix}"
-        self.durable_payload = {"value": f"volcano-sdk-contract-{suffix}"}
+        self.durable_execution_name: str = (
+            f"{fixture['durable_function_name']}-{suffix}"
+        )
+        self.durable_payload: dict[str, str] = {
+            "value": f"volcano-sdk-contract-{suffix}"
+        }
         self.started_execution: DurableExecution | None = None
         self.last_outcome: Outcome | None = None
         self.previous_session: Session | None = None
@@ -161,10 +165,10 @@ class ContractWorld:
         self.publisher: Channel | None = None
         self.realtime_clients: list[VolcanoClient] = []
         self.cleanup_callbacks: list[Callable[[], None]] = []
-        self.loop = asyncio.new_event_loop()
+        self.loop: asyncio.AbstractEventLoop = asyncio.new_event_loop()
 
     def authenticate(self) -> None:
-        self.client.auth.sign_in(
+        _ = self.client.auth.sign_in(
             email=self.fixture["user_email"],
             password=self.fixture["user_password"],
         )

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/features/environment.py

@@ -4,7 +4,7 @@ import json
 import os
 import stat
 from pathlib import Path
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, cast
 
 from contract_fixture import ContractFixture, is_contract_fixture
 from contract_support import ContractWorld
@@ -27,7 +27,7 @@ def load_fixture(path: Path) -> ContractFixture:
     mode = stat.S_IMODE(path.stat().st_mode)
     if mode != FIXTURE_MODE:
         raise PermissionError(FIXTURE_MODE_ERROR)
-    value: object = json.loads(path.read_text(encoding="utf-8"))
+    value = cast("object", json.loads(path.read_text(encoding="utf-8")))
     if not is_contract_fixture(value):
         raise TypeError(FIXTURE_SHAPE_ERROR)
     return value
@@ -42,9 +42,14 @@ def before_all(context: Context) -> None:
 
 def before_scenario(context: Context, scenario: object) -> None:
     del scenario
-    context.contract = ContractWorld(context.contract_fixture)
+    fixture = cast("object", context.contract_fixture)
+    if not is_contract_fixture(fixture):
+        raise TypeError(FIXTURE_SHAPE_ERROR)
+    context.contract = ContractWorld(fixture)
 
 
 def after_scenario(context: Context, scenario: object) -> None:
     del scenario
-    context.contract.cleanup()
+    world = cast("object", context.contract)
+    assert isinstance(world, ContractWorld)
+    world.cleanup()

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/features/logs_contract.py

@@ -73,14 +73,14 @@ def bucket_total(bucket: Mapping[str, JSONValue]) -> int:
 
 class LogContract:
     def __init__(self, world: ContractWorld) -> None:
-        self.world = world
-        self.client = VolcanoClient(
+        self.world: ContractWorld = world
+        self.client: VolcanoClient = VolcanoClient(
             api_url=world.fixture["api_url"],
             anon_key=world.fixture["anon_key"],
             access_token=world.fixture["logs_access_token"],
             timeout=10,
         )
-        self.marker = f"sdklogs{uuid4().hex}"
+        self.marker: str = f"sdklogs{uuid4().hex}"
         self.request: dict[str, JSONValue] = {
             "resource": {"type": "function", "ids": [world.fixture["function_id"]]},
             "q": self.marker,

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/features/postgres_changes.py

@@ -6,7 +6,7 @@ from typing import TYPE_CHECKING
 from uuid import uuid4
 
 if TYPE_CHECKING:
-    from collections.abc import Mapping
+    from collections.abc import Callable, Mapping
 
     from contract_support import ContractWorld
 
@@ -17,12 +17,12 @@ if TYPE_CHECKING:
 
 class ChangeObserver:
     def __init__(self, channel: Channel, table: str, row_id: JSONValue) -> None:
-        self.row_id = row_id
+        self.row_id: JSONValue = row_id
         self.events: list[PostgresChange] = []
         self.queue: asyncio.Queue[PostgresChange] = asyncio.Queue()
         self.inserts: list[PostgresChange] = []
         self.wrong_table: list[PostgresChange] = []
-        self.stops = [
+        self.stops: list[Callable[[], None]] = [
             channel.on_postgres_changes(
                 "*", schema="public", table=table, callback=self.record
             ),
@@ -72,7 +72,7 @@ def verify_change(
     automatic: bool,
 ) -> None:
     assert (event.type, event.schema, event.table) == (kind, "public", table)
-    datetime.fromisoformat(event.timestamp)
+    _ = datetime.fromisoformat(event.timestamp)
     if automatic:
         assert event.record == row
         assert event.id is None
@@ -84,7 +84,7 @@ def verify_change(
 
 
 def remove_row(table: QueryBuilder, row_id: JSONValue) -> None:
-    table.delete().eq("id", row_id).execute()
+    _ = table.delete().eq("id", row_id).execute()
 
 
 async def verify_postgres_changes(world: ContractWorld) -> list[str]:
@@ -99,7 +99,7 @@ async def verify_postgres_changes(world: ContractWorld) -> list[str]:
     channels = postgres_channels(world, table_name)
     observers = [ChangeObserver(channel, table_name, row["id"]) for channel in channels]
     try:
-        await asyncio.gather(*(channel.subscribe() for channel in channels))
+        _ = await asyncio.gather(*(channel.subscribe() for channel in channels))
         for index, kind in enumerate(["INSERT", "UPDATE"]):
             expected = {**row, "value": "inserted" if index == 0 else "updated"}
             operation = (
@@ -120,7 +120,7 @@ async def verify_postgres_changes(world: ContractWorld) -> list[str]:
     finally:
         for observer in observers:
             observer.close()
-        await asyncio.gather(*(channel.unsubscribe() for channel in channels))
+        _ = await asyncio.gather(*(channel.unsubscribe() for channel in channels))
     return ["INSERT", "UPDATE"]
 
 

{volcano_sdk_python-0.11.2 → volcano_sdk_python-0.11.3}/features/presence_membership.py

@@ -13,11 +13,11 @@ if TYPE_CHECKING:
 
 class PresenceObserver:
     def __init__(self, channel: Channel, user_id: str) -> None:
-        self.channel = channel
-        self.user_id = user_id
-        self.changed = asyncio.Event()
+        self.channel: Channel = channel
+        self.user_id: str = user_id
+        self.changed: asyncio.Event = asyncio.Event()
         self.snapshots: list[set[str]] = []
-        self.unsubscribe = channel.on_presence_sync(self.record)
+        self.unsubscribe: Callable[[], None] = channel.on_presence_sync(self.record)
 
     def record(self, state: Mapping[str, RealtimePresenceInfo]) -> None:
         self.snapshots.append(set(state))
@@ -29,7 +29,7 @@ class PresenceObserver:
                 self.changed.clear()
                 if predicate():
                     return
-                await self.changed.wait()
+                _ = await self.changed.wait()
 
     async def roster(self, count: int) -> set[str]:
         await self.wait(lambda: len(self.channel.get_presence_state()) == count)
@@ -56,16 +56,16 @@ async def verify_presence_membership(world: ContractWorld) -> list[int]:
         await second.unsubscribe()
         assert await first_observer.roster(1) == initial
         await first_observer.wait(
-            lambda: _observed_membership(first_observer.snapshots, initial, joined)
+            lambda: observed_membership(first_observer.snapshots, initial, joined)
         )
         return [1, 2, 1]
     finally:
         first_observer.unsubscribe()
         second_observer.unsubscribe()
-        await asyncio.gather(first.unsubscribe(), second.unsubscribe())
+        _ = await asyncio.gather(first.unsubscribe(), second.unsubscribe())
 
 
-def _observed_membership(
+def observed_membership(
     snapshots: list[set[str]], initial: set[str], joined: set[str]
 ) -> bool:
     expected = iter([initial, joined, initial])