volcano-sdk-python 0.10.2__tar.gz → 0.10.4__tar.gz

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/.github/workflows/ci.yml

@@ -25,7 +25,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.11", "3.14"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:

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

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

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.10.4](https://github.com/Kong/volcano-sdk-python/compare/v0.10.3...v0.10.4) (2026-09-23)
+
+
+### Bug Fixes
+
+* **types:** validate transport payloads before facade access ([#287](https://github.com/Kong/volcano-sdk-python/issues/287)) ([60e280c](https://github.com/Kong/volcano-sdk-python/commit/60e280ca0665ea5a143dc8df69a3d3cc2bdbb481))
+
+## [0.10.3](https://github.com/Kong/volcano-sdk-python/compare/v0.10.2...v0.10.3) (2026-09-23)
+
+
+### Bug Fixes
+
+* **types:** validate database rows before returning them ([#285](https://github.com/Kong/volcano-sdk-python/issues/285)) ([e0ee14d](https://github.com/Kong/volcano-sdk-python/commit/e0ee14d28f5cf9d96ebdc3f07aa3b83f40c191e8))
+
 ## [0.10.2](https://github.com/Kong/volcano-sdk-python/compare/v0.10.1...v0.10.2) (2026-09-22)
 
 

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to the Python SDK
 
-Use Python 3.11 or newer and `uv`. CI covers Python 3.11 and 3.14.
+Use Python 3.11 or newer and `uv`. CI covers every Python version from 3.11 through 3.14.
 
 ## Verify a change
 

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: volcano-sdk-python
-Version: 0.10.2
+Version: 0.10.4
 Summary: Official Python SDK for Volcano
 Project-URL: Homepage, https://volcano.dev
 Project-URL: Repository, https://github.com/Kong/volcano-sdk-python
@@ -11,6 +11,8 @@ License-File: LICENSE
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.11
 Requires-Dist: attrs>=26.1.0
@@ -330,6 +332,10 @@ the clock or a random value.
 | `ctx.child(name, fn)` | Groups operations under one recorded context. |
 | `ctx.log` | The execution's logger, suppressed while an operation is replayed. |
 
+`ctx.log` and a step's `scope.log` expose `debug`, `info`, `warning`, `error`,
+and `exception`. They accept a message, formatting arguments, and an optional
+`extra` mapping. Messages are suppressed during replay.
+
 `ctx.map` and `ctx.parallel` both return a batch result: `items` (the items that
 finished, each with `index`, `status`, `result`, `error`), `results`, `errors`,
 `succeeded`, `failed`, `completed`, `completion_reason`, and `throw_if_failed()`.
@@ -966,7 +972,8 @@ does not need it otherwise.
 
 ## Compatibility
 
-CI tests the SDK on Python 3.11 and 3.14. Its public facade is intentionally
+CI tests the SDK on every Python version from 3.11 through 3.14.
+Its public facade is intentionally
 independent of generated httpx types. The bundled `openapi/openapi.yaml` matches
 the public bundle from [Hosting #991](https://github.com/Kong/volcano-hosting/pull/991)
 at commit `ef03f689e`.

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/README.md

@@ -307,6 +307,10 @@ the clock or a random value.
 | `ctx.child(name, fn)` | Groups operations under one recorded context. |
 | `ctx.log` | The execution's logger, suppressed while an operation is replayed. |
 
+`ctx.log` and a step's `scope.log` expose `debug`, `info`, `warning`, `error`,
+and `exception`. They accept a message, formatting arguments, and an optional
+`extra` mapping. Messages are suppressed during replay.
+
 `ctx.map` and `ctx.parallel` both return a batch result: `items` (the items that
 finished, each with `index`, `status`, `result`, `error`), `results`, `errors`,
 `succeeded`, `failed`, `completed`, `completion_reason`, and `throw_if_failed()`.
@@ -943,7 +947,8 @@ does not need it otherwise.
 
 ## Compatibility
 
-CI tests the SDK on Python 3.11 and 3.14. Its public facade is intentionally
+CI tests the SDK on every Python version from 3.11 through 3.14.
+Its public facade is intentionally
 independent of generated httpx types. The bundled `openapi/openapi.yaml` matches
 the public bundle from [Hosting #991](https://github.com/Kong/volcano-hosting/pull/991)
 at commit `ef03f689e`.

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/docs/README.md

@@ -6,7 +6,7 @@ order: 1
 
 Use `volcano-sdk-python` for authentication, database queries, storage, functions, logs, locks, and realtime events.
 REST calls are synchronous and raise typed exceptions on failure.
-Python 3.11 or later is required; CI tests Python 3.11 and 3.14.
+Python 3.11 or later is required; CI tests every Python version from 3.11 through 3.14.
 
 ## Install the published package
 

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/docs/versions.md

@@ -16,7 +16,7 @@ Keep the resolved dependency lock used by your application and install from that
 
 ## Runtime and compatibility
 
-Use Python 3.11 or later. Native CI tests Python 3.11 and 3.14; it does not test every intervening interpreter release. REST methods are synchronous, while realtime uses an asynchronous lifecycle.
+Use Python 3.11 or later. Native CI tests every Python version from 3.11 through 3.14. REST methods are synchronous, while realtime uses an asynchronous lifecycle.
 
 The package is currently on the 0.x release line. Treat a minor-version update as potentially incompatible and read its release notes before upgrading.
 JavaScript, Python and Ruby releases have independent version numbers; matching numbers are not a compatibility requirement.

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/features/broadcast_pause.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import asyncio
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from contract_support import ContractWorld
@@ -10,8 +10,8 @@ if TYPE_CHECKING:
 
 
 async def _publish_and_receive(
-    publisher: Channel, received: asyncio.Queue[Any], message: dict[str, Any]
-) -> Any:
+    publisher: Channel, received: asyncio.Queue[object], message: dict[str, str]
+) -> object:
     async with asyncio.timeout(10):
         await publisher.send(message)
         while True:
@@ -20,14 +20,14 @@ async def _publish_and_receive(
                 return delivered
 
 
-async def verify_broadcast_pause(world: ContractWorld) -> Any:
+async def verify_broadcast_pause(world: ContractWorld) -> object:
     subscriber, publisher = world.subscriber, world.publisher
     assert subscriber is not None
     assert publisher is not None
-    received: asyncio.Queue[Any] = asyncio.Queue()
-    delivered: list[Any] = []
+    received: asyncio.Queue[object] = asyncio.Queue()
+    delivered: list[object] = []
 
-    def on_message(message: Any) -> None:
+    def on_message(message: object) -> None:
         delivered.append(message)
         received.put_nowait(message)
 

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/features/contract_support.py

@@ -7,8 +7,6 @@ import time
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any
 
-from centrifuge import CentrifugeError
-
 from volcano_sdk import (
     AuthenticationError,
     ConflictError,
@@ -21,6 +19,7 @@ from volcano_sdk import (
     VolcanoClient,
     VolcanoError,
 )
+from volcano_sdk.realtime import CENTRIFUGE_ERROR
 
 if TYPE_CHECKING:
     from collections.abc import Awaitable, Callable
@@ -51,7 +50,7 @@ DURABLE_POLL_TIMEOUT_SECONDS = 300
 OWNER_SESSION_PLACEHOLDER = "sdk-contract-platform-token-has-no-auth-session"
 
 CONTRACT_EXCEPTIONS = (
-    CentrifugeError,
+    CENTRIFUGE_ERROR,
     KeyError,
     OSError,
     RuntimeError,

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/features/environment.py

@@ -4,7 +4,7 @@ import json
 import os
 import stat
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 from contract_support import ContractWorld
 
@@ -15,7 +15,7 @@ FIXTURE_OBJECT_ERROR = "VOLCANO_SDK_CONTRACT_FIXTURE must contain a JSON object"
 FIXTURE_REQUIRED_ERROR = "VOLCANO_SDK_CONTRACT_FIXTURE is required"
 
 
-def load_fixture(path: Path) -> dict[str, Any]:
+def load_fixture(path: Path) -> dict[str, object]:
     if not path.is_absolute():
         raise ValueError(FIXTURE_ABSOLUTE_PATH_ERROR)
     mode = stat.S_IMODE(path.stat().st_mode)
@@ -24,7 +24,8 @@ def load_fixture(path: Path) -> dict[str, Any]:
     value = json.loads(path.read_text(encoding="utf-8"))
     if not isinstance(value, dict):
         raise TypeError(FIXTURE_OBJECT_ERROR)
-    return value
+    # JSON objects have string keys; the shape check above rejects other values.
+    return cast("dict[str, object]", value)
 
 
 def before_all(context: Any) -> None:

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/features/logs_contract.py

@@ -2,17 +2,28 @@ from __future__ import annotations
 
 import time
 from datetime import UTC, datetime, timedelta
-from typing import Any
+from typing import TYPE_CHECKING, Any, TypeVar
 from uuid import uuid4
 
 from volcano_sdk import VolcanoClient
 
+if TYPE_CHECKING:
+    from collections.abc import Callable, Mapping
+
+    from volcano_sdk.models import JSONValue
+
+_ResultT = TypeVar("_ResultT")
+
 LOG_EVENT_COUNT = 3
 ACTIVITY_BUCKET_COUNT = 2
 HTTP_OK = 200
 
 
-def poll(operation: Any, ready: Any, seconds: int) -> Any:
+def poll(
+    operation: Callable[[], _ResultT],
+    ready: Callable[[_ResultT], bool],
+    seconds: int,
+) -> _ResultT:
     deadline = time.monotonic() + seconds
     while True:
         result = operation()
@@ -24,6 +35,12 @@ def poll(operation: Any, ready: Any, seconds: int) -> Any:
         time.sleep(min(1, max(0, deadline - time.monotonic())))
 
 
+def event_id(event: Mapping[str, JSONValue]) -> str:
+    identity = event["id"]
+    assert isinstance(identity, str)
+    return identity
+
+
 class LogContract:
     def __init__(self, world: Any) -> None:
         self.world = world
@@ -64,7 +81,7 @@ class LogContract:
             240,
         )
         assert len(page.data) == LOG_EVENT_COUNT
-        expected_ids = {event["id"] for event in page.data}
+        expected_ids = {event_id(event) for event in page.data}
         events: list[Any] = []
         request = {**self.request, "limit": 1}
         for _ in range(LOG_EVENT_COUNT):
@@ -77,7 +94,7 @@ class LogContract:
             assert page.next_cursor
             request = {**request, "cursor": page.next_cursor}
         assert not page.has_more
-        assert {event["id"] for event in events} == expected_ids
+        assert {event_id(event) for event in events} == expected_ids
         return events
 
     def activity(self) -> Any:
@@ -93,7 +110,7 @@ class LogContract:
         assert len(events) == LOG_EVENT_COUNT
         assert len({event["id"] for event in events}) == LOG_EVENT_COUNT
         assert sorted(event["body"]["ordinal"] for event in events) == [0, 1, 2]
-        timestamps = []
+        timestamps: list[datetime] = []
         for event in events:
             assert event["id"]
             assert event["body"] == {

{volcano_sdk_python-0.10.2 → volcano_sdk_python-0.10.4}/features/postgres_changes.py

@@ -10,6 +10,7 @@ if TYPE_CHECKING:
 
     from contract_support import ContractWorld
 
+    from volcano_sdk.database import QueryBuilder
     from volcano_sdk.models import JSONValue
     from volcano_sdk.realtime import Channel, PostgresChange
 
@@ -82,6 +83,10 @@ def verify_change(
         assert event.record is None
 
 
+def remove_row(table: QueryBuilder, row_id: JSONValue) -> None:
+    table.delete().eq("id", row_id).execute()
+
+
 async def verify_postgres_changes(world: ContractWorld) -> list[str]:
     table_name = world.fixture["realtime_table_name"]
     row: dict[str, JSONValue] = {
@@ -90,7 +95,7 @@ async def verify_postgres_changes(world: ContractWorld) -> list[str]:
         "owner_id": world.fixture["user_id"],
     }
     table = world.client.database(world.fixture["database_name"]).from_(table_name)
-    world.cleanup_callbacks.append(lambda: table.delete().eq("id", row["id"]).execute())
+    world.cleanup_callbacks.append(lambda: remove_row(table, row["id"]))
     channels = postgres_channels(world, table_name)
     observers = [ChangeObserver(channel, table_name, row["id"]) for channel in channels]
     try: