workers-runtime-sdk 1.9.0__tar.gz → 1.9.2__tar.gz

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 <!-- version list -->
 
+## v1.9.2 (2026-09-30)
+
+### Bug Fixes
+
+- **runtime-sdk**: Fix top-level entropy calls in fastapi >= 0.142.0
+  ([#283](https://github.com/cloudflare/workers-py/pull/283),
+  [`f0b104e`](https://github.com/cloudflare/workers-py/commit/f0b104eb0b9204fc877f34f59d510f6ef75f1833))
+
+
+## v1.9.1 (2026-09-29)
+
+### Bug Fixes
+
+- **runtime-sdk**: Add rpds to rust package entropy context
+  ([#277](https://github.com/cloudflare/workers-py/pull/277),
+  [`a097b7c`](https://github.com/cloudflare/workers-py/commit/a097b7c5d2e5bba17f34d46abb6e39039d4673d4))
+
+
 ## v1.9.0 (2026-09-18)
 
 ### Bug Fixes

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: workers-runtime-sdk
-Version: 1.9.0
+Version: 1.9.2
 Summary: Python SDK for Cloudflare Workers
 Project-URL: Homepage, https://github.com/cloudflare/workers-py
 Project-URL: Bug Tracker, https://github.com/cloudflare/workers-py/issues

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "workers-runtime-sdk"
-version = "1.9.0"
+version = "1.9.2"
 description = "Python SDK for Cloudflare Workers"
 readme = "README.md"
 requires-python = ">=3.11"

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/src/_workers_sdk_entropy_import_context.py

@@ -49,6 +49,7 @@ class STATE:
 @register_create_patch("tiktoken._tiktoken")
 @register_exec_patch("cryptography.exceptions")
 @register_exec_patch("jiter")
+@register_exec_patch("rpds")
 @register_exec_patch("uuid_utils._uuid_utils")
 @contextmanager
 def rust_package_context(module):
@@ -228,6 +229,15 @@ def opentelemetry_baggage_context(module):
         yield
 
 
+@register_exec_patch("fastapi.telemetry")
+@contextmanager
+def fastapi_telemetry_context(module):
+    # fastapi 0.142.0 added opentelemetry support
+    # which creates a UUID-backed key.
+    with allow_bad_entropy_calls_for_version("fastapi", 1, (0, 142, 0)):
+        yield
+
+
 @register_exec_patch("litestar.openapi.controller")
 @register_exec_patch("litestar.constants")
 @contextmanager

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/tests/bindings-test/pyproject.toml

@@ -7,13 +7,18 @@ dependencies = [
     "pytest-asyncio<1.2.0",
     # These are for hyperdrive tests
     "pg8000",
-    "pymysql",
+    # There is a regression in upstream pymysql.
+    # Remove when the following PR is merged and released.
+    # https://github.com/PyMySQL/PyMySQL/pull/1275
+    "pymysql<=1.2.0",
     "aiomysql",
     "psycopg[binary]; python_version >= '3.14'",
     "asyncpg; python_version >= '3.14'",
     "cryptography",
     "testlib",
+    "workers-runtime-sdk",
 ]
 
 [tool.uv.sources]
-testlib = { path = "../testlib/dist/testlib-0.0.0-py3-none-any.whl" }
+testlib = { path = "../packages/testlib" }
+workers-runtime-sdk = { path = "../packages/runtime-sdk" }

workers_runtime_sdk-1.9.2/tests/conftest.py

@@ -0,0 +1,68 @@
+"""Shared fixtures and helpers for the host-side test suite."""
+
+from pathlib import Path
+from typing import Any
+
+import pytest
+from testlib.host import (
+    COMPAT_CONFIGS,
+    CompatConfig,
+    dev_server,
+)
+from testlib.host import (
+    register_in_worker_suites as register_testlib_suites,
+)
+
+__all__ = ["dev_server"]
+
+
+TEST_DIR: Path = Path(__file__).parent
+
+OPT_IN_MARKERS: tuple[str, ...] = ("hyperdrive",)
+
+
+def pytest_collection_modifyitems(
+    config: pytest.Config, items: list[pytest.Item]
+) -> None:
+    """Skip opt-in suites unless the run explicitly asks for them via ``-m``."""
+    markexpr: str = config.getoption("markexpr")
+    for marker in OPT_IN_MARKERS:
+        if marker in markexpr:
+            continue
+        skip = pytest.mark.skip(reason=f"needs local services; run with -m {marker}")
+        for item in items:
+            if marker in item.keywords:
+                item.add_marker(skip)
+
+
+@pytest.fixture(
+    scope="module",
+    params=COMPAT_CONFIGS,
+    ids=[c.python_version for c in COMPAT_CONFIGS],
+)
+def compat_config(request: pytest.FixtureRequest) -> CompatConfig:
+    return request.param
+
+
+@pytest.fixture(scope="module")
+def worker_project_dir() -> Path:
+    """Worker project the `dev_server` fixture should serve.
+
+    Test modules using `dev_server` must override this fixture.
+    """
+    raise NotImplementedError(
+        "override the `worker_project_dir` fixture in your test module"
+    )
+
+
+@pytest.fixture(scope="module")
+def dev_startup_timeout():
+    return 120
+
+
+def register_in_worker_suites(
+    namespace: dict[str, Any],
+    src_dir: Path,
+    marks: dict[str, pytest.MarkDecorator] | None = None,
+) -> None:
+    register_testlib_suites(namespace, src_dir, marks=marks)

workers_runtime_sdk-1.9.2/tests/test_django_databases.py

@@ -0,0 +1,37 @@
+# pyright: reportAttributeAccessIssue=false, reportMissingImports=false
+
+"""Stock Django database backends running through Hyperdrive in workerd."""
+
+from pathlib import Path
+
+import pytest
+from conftest import COMPAT_CONFIGS, CompatConfig, register_in_worker_suites
+
+DJANGO_DATABASES_DIR: Path = (
+    Path(__file__).parent / "web-frameworks-test" / "django-databases"
+)
+DJANGO_DATABASES_SRC_DIR: Path = DJANGO_DATABASES_DIR / "src"
+PYTHON_314_CONFIGS = [
+    config for config in COMPAT_CONFIGS if config.python_version == "3.14"
+]
+SUITE_MARKS: dict[str, pytest.MarkDecorator] = {
+    "postgresql": pytest.mark.hyperdrive,
+    "mysql": pytest.mark.hyperdrive,
+}
+
+
+@pytest.fixture(scope="module")
+def worker_project_dir() -> Path:
+    return DJANGO_DATABASES_DIR
+
+
+@pytest.fixture(
+    scope="module",
+    params=PYTHON_314_CONFIGS,
+    ids=[config.python_version for config in PYTHON_314_CONFIGS],
+)
+def compat_config(request: pytest.FixtureRequest) -> CompatConfig:
+    return request.param
+
+
+register_in_worker_suites(globals(), DJANGO_DATABASES_SRC_DIR, marks=SUITE_MARKS)

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/tests/test_in_workerd.py

@@ -7,13 +7,15 @@ import pytest
 from conftest import (
     COMPAT_CONFIGS,
     CompatConfig,
+)
+from testlib.host import (
     configure_compatibility,
+    link_packages,
+    pywrangler_sync,
 )
 
 TEST_DIR = Path(__file__).parent
 WORKERD_TESTS = TEST_DIR / "workerd-test"
-WORKERS_PY = TEST_DIR.parent.parent / "cli"
-WORKERS_RUNTIME_SDK = TEST_DIR.parent / "src"
 DISK_SERVICE_NAME = "TEST_TMPDIR"
 
 
@@ -123,23 +125,14 @@ def test_in_workerd(  # noqa: PLR0913, PLR0917  (too-many-arguments)
     target = tmp_path / test_dir.name
     disk_service_dir = target / DISK_SERVICE_NAME
     shutil.copytree(test_dir, target, ignore=shutil.ignore_patterns(".venv"))
+    # Makes the project's `../packages/{runtime-sdk,testlib}` sources resolve
+    # so `sync` vendors the working-tree SDK and testlib.
+    link_packages(tmp_path)
     disk_service_dir.mkdir(exist_ok=True)
 
     configure_compatibility(target / "wrangler.jsonc", compat_config)
 
-    pywrangler_cmd = ["uv", "run", "--no-project", "--with", WORKERS_PY, "pywrangler"]
-
-    subprocess.run(
-        [*pywrangler_cmd, "sync"],
-        cwd=target,
-        check=True,
-        env=os.environ | {"_PYODIDE_EXTRA_MOUNTS": str(tmp_path)},
-    )
-
-    # Copy runtime-sdk to the python modules as well
-    # FIXME: remove this and pass runtime-sdk as a dependency explicitly after
-    #        https://github.com/cloudflare/workers-py/pull/81 is merged
-    shutil.copytree(WORKERS_RUNTIME_SDK, target / "python_modules", dirs_exist_ok=True)
+    pywrangler_sync(target, os.environ | {"_PYODIDE_EXTRA_MOUNTS": str(tmp_path)})
 
     modules = embed(target / "python_modules", target, level=1) + embed(
         target / "tests", target, level=1

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/tests/web-frameworks-test/django-async/pyproject.toml

@@ -11,7 +11,9 @@ dependencies = [
     "pytest",
     "pytest-asyncio<1.2.0",
     "testlib",
+    "workers-runtime-sdk",
 ]
 
 [tool.uv.sources]
-testlib = { path = "../testlib/dist/testlib-0.0.0-py3-none-any.whl" }
+testlib = { path = "../packages/testlib" }
+workers-runtime-sdk = { path = "../packages/runtime-sdk" }

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/django-databases/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "django-databases-test"
+version = "0.1.0"
+requires-python = ">=3.14"
+dependencies = [
+    "django>=5.2.8",
+    "mysqlclient",
+    "psycopg[binary]",
+    "pytest",
+    "testlib",
+    "workers-runtime-sdk",
+]
+
+[tool.uv.sources]
+testlib = { path = "../packages/testlib" }
+workers-runtime-sdk = { path = "../packages/runtime-sdk" }

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/django-databases/src/django_db_config.py

@@ -0,0 +1,61 @@
+# pyright: reportMissingImports=false
+
+"""Django settings for stock backends running through Hyperdrive."""
+
+import os
+
+import django
+from django.conf import settings
+
+from workers import env
+
+os.environ.setdefault("DJANGO_ALLOW_ASYNC_UNSAFE", "true")
+
+HYPERDRIVE_POSTGRESQL = "hyperdrive_postgresql"
+HYPERDRIVE_MYSQL = "hyperdrive_mysql"
+
+
+def _postgresql_database() -> dict[str, object]:
+    hyperdrive = env.HYPERDRIVE_PG
+    return {
+        "ENGINE": "django.db.backends.postgresql",
+        "HOST": hyperdrive.host,
+        "PORT": str(hyperdrive.port),
+        "USER": hyperdrive.user,
+        "PASSWORD": hyperdrive.password,
+        "NAME": hyperdrive.database,
+        "CONN_MAX_AGE": 0,
+        "OPTIONS": {"sslmode": "disable"},
+        "DISABLE_SERVER_SIDE_CURSORS": True,
+    }
+
+
+def _mysql_database() -> dict[str, object]:
+    hyperdrive = env.HYPERDRIVE_MYSQL
+    return {
+        "ENGINE": "django.db.backends.mysql",
+        "HOST": hyperdrive.host,
+        "PORT": str(hyperdrive.port),
+        "USER": hyperdrive.user,
+        "PASSWORD": hyperdrive.password,
+        "NAME": hyperdrive.database,
+        "CONN_MAX_AGE": 0,
+        "OPTIONS": {"ssl_mode": "DISABLED"},
+    }
+
+
+settings.configure(
+    DEBUG=False,
+    SECRET_KEY="test-secret-key-for-workers-py",
+    INSTALLED_APPS=[],
+    DATABASES={
+        "default": {"ENGINE": "django.db.backends.dummy"},
+        HYPERDRIVE_POSTGRESQL: _postgresql_database(),
+        HYPERDRIVE_MYSQL: _mysql_database(),
+    },
+    TIME_ZONE="UTC",
+    USE_TZ=True,
+    DEFAULT_AUTO_FIELD="django.db.models.BigAutoField",
+)
+
+django.setup()

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/django-databases/src/django_db_helpers.py

@@ -0,0 +1,100 @@
+"""ORM assertions shared by the independent Django backend suites."""
+
+import uuid
+from collections.abc import Iterator
+from contextlib import contextmanager
+
+import pytest
+from django.db import connections, models, transaction
+from django.test.utils import isolate_apps
+
+
+class Rollback(Exception):
+    """Raised to roll back an atomic block."""
+
+
+def _table_name() -> str:
+    return f"dht_{uuid.uuid4().hex}"
+
+
+@contextmanager
+def _temporary_model(alias: str) -> Iterator[type[models.Model]]:
+    table_name = _table_name()
+    connection = connections[alias]
+
+    with isolate_apps():
+
+        class TemporaryModel(models.Model):
+            name = models.CharField(max_length=100)
+            value = models.IntegerField()
+            float_value = models.FloatField(default=0.0)
+            is_active = models.BooleanField(default=False)
+
+            class Meta:
+                app_label = "hyperdrive_tests"
+                db_table = table_name
+
+        created = False
+        try:
+            with connection.schema_editor() as schema_editor:
+                schema_editor.create_model(TemporaryModel)
+            created = True
+            yield TemporaryModel
+        finally:
+            if created:
+                with connection.schema_editor() as schema_editor:
+                    schema_editor.delete_model(TemporaryModel)
+
+
+def assert_connectivity(alias: str) -> None:
+    connection = connections[alias]
+    connection.ensure_connection()
+    assert connection.is_usable()
+
+
+def assert_crud(alias: str) -> None:
+    with _temporary_model(alias) as model:
+        objects = model.objects.using(alias)
+        objects.create(name="alpha", value=1)
+        objects.create(name="beta", value=2)
+
+        assert list(
+            objects.filter(name__in=["alpha", "beta"])
+            .order_by("name")
+            .values_list("name", "value")
+        ) == [("alpha", 1), ("beta", 2)]
+
+        assert objects.filter(name="alpha").update(value=11) == 1
+        assert objects.get(name="alpha").value == 11
+
+        assert objects.filter(name="alpha").delete()[0] == 1
+        assert objects.count() == 1
+        assert objects.get(name="beta").value == 2
+
+
+def assert_data_types(alias: str) -> None:
+    with _temporary_model(alias) as model:
+        objects = model.objects.using(alias)
+        created = objects.create(
+            name="hello",
+            value=42,
+            float_value=3.14,
+            is_active=True,
+        )
+        row = objects.get(pk=created.pk)
+
+        assert row.name == "hello"
+        assert row.value == 42
+        assert abs(row.float_value - 3.14) < 0.001
+        assert row.is_active is True
+
+
+def assert_transaction_rollback(alias: str) -> None:
+    with _temporary_model(alias) as model:
+        objects = model.objects.using(alias)
+
+        with pytest.raises(Rollback), transaction.atomic(using=alias):
+            objects.create(name="should_disappear", value=1)
+            raise Rollback
+
+        assert objects.count() == 0

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/django-databases/src/test_mysql.py

@@ -0,0 +1,35 @@
+# pyright: reportMissingImports=false
+
+"""Stock Django MySQL backend running through the HYPERDRIVE_MYSQL binding."""
+
+import pytest
+from django.db import connections
+from django_db_config import HYPERDRIVE_MYSQL
+from django_db_helpers import (
+    assert_connectivity,
+    assert_crud,
+    assert_data_types,
+    assert_transaction_rollback,
+)
+
+
+@pytest.fixture(autouse=True)
+def close_connections():
+    yield
+    connections[HYPERDRIVE_MYSQL].close()
+
+
+def test_connectivity():
+    assert_connectivity(HYPERDRIVE_MYSQL)
+
+
+def test_crud():
+    assert_crud(HYPERDRIVE_MYSQL)
+
+
+def test_data_types():
+    assert_data_types(HYPERDRIVE_MYSQL)
+
+
+def test_transaction_rollback():
+    assert_transaction_rollback(HYPERDRIVE_MYSQL)

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/django-databases/src/test_postgresql.py

@@ -0,0 +1,35 @@
+# pyright: reportMissingImports=false
+
+"""Stock Django PostgreSQL backend running through the HYPERDRIVE_PG binding."""
+
+import pytest
+from django.db import connections
+from django_db_config import HYPERDRIVE_POSTGRESQL
+from django_db_helpers import (
+    assert_connectivity,
+    assert_crud,
+    assert_data_types,
+    assert_transaction_rollback,
+)
+
+
+@pytest.fixture(autouse=True)
+def close_connections():
+    yield
+    connections[HYPERDRIVE_POSTGRESQL].close()
+
+
+def test_connectivity():
+    assert_connectivity(HYPERDRIVE_POSTGRESQL)
+
+
+def test_crud():
+    assert_crud(HYPERDRIVE_POSTGRESQL)
+
+
+def test_data_types():
+    assert_data_types(HYPERDRIVE_POSTGRESQL)
+
+
+def test_transaction_rollback():
+    assert_transaction_rollback(HYPERDRIVE_POSTGRESQL)

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/django-databases/src/worker.py

@@ -0,0 +1,9 @@
+# pyright: reportMissingImports=false
+
+"""Django database backend test worker."""
+
+from testlib.entrypoint import TestRunnerEntrypoint
+
+
+class Default(TestRunnerEntrypoint):
+    pass

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/django-databases/wrangler.jsonc

@@ -0,0 +1,18 @@
+{
+    "name": "django-databases-test",
+    "main": "src/worker.py",
+    "compatibility_date": "%COMPAT_DATE",
+    "compatibility_flags": ["python_workers"],
+    "hyperdrive": [
+        {
+            "binding": "HYPERDRIVE_PG",
+            "id": "00000000-0000-0000-0000-000000000001",
+            "localConnectionString": "postgres://testuser:testpass@127.0.0.1:5432/testdb"
+        },
+        {
+            "binding": "HYPERDRIVE_MYSQL",
+            "id": "00000000-0000-0000-0000-000000000002",
+            "localConnectionString": "mysql://testuser:testpass@127.0.0.1:3306/testdb"
+        }
+    ]
+}

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/tests/web-frameworks-test/fastapi-tests/pyproject.toml

@@ -8,7 +8,9 @@ dependencies = [
     "pytest",
     "pytest-asyncio<1.2.0",
     "testlib",
+    "workers-runtime-sdk",
 ]
 
 [tool.uv.sources]
-testlib = { path = "../testlib/dist/testlib-0.0.0-py3-none-any.whl" }
+testlib = { path = "../packages/testlib" }
+workers-runtime-sdk = { path = "../packages/runtime-sdk" }

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/tests/web-frameworks-test/fastapi-tests/src/worker.py

@@ -30,21 +30,12 @@ from fastapi.responses import (
 from fastapi.responses import Response as FastAPIResponse
 from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel
-from pyodide.webloop import WebLoop
 from starlette.background import BackgroundTask
 from starlette.middleware.gzip import GZipMiddleware
-from testlib.entrypoint import TestRunner
+from testlib.entrypoint import RunSuiteRequest, TestRunner
 
 import asgi
 
-
-async def _noop(*args):
-    pass
-
-
-WebLoop.shutdown_asyncgens = _noop
-WebLoop.shutdown_default_executor = _noop
-
 STATIC_DIR = Path(__file__).parent / "static"
 
 
@@ -603,7 +594,9 @@ class FastAPIAppPlugin:
 @app.get("/run-tests/{suite_name:path}")
 async def run_suite(suite_name: str, request: Request):
     runner = TestRunner(request.scope["env"], extra_plugins=[FastAPIAppPlugin()])
-    result = runner.run_suite(suite_name)
+    result = runner.run_suite(
+        suite_name, RunSuiteRequest.from_query_params(request.query_params)
+    )
     return JSONResponse(result.payload, status_code=result.status)
 
 

workers_runtime_sdk-1.9.2/tests/web-frameworks-test/flask-tests/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "flask-tests"
+version = "0.1.0"
+requires-python = ">=3.12"
+dependencies = ["flask", "pytest", "testlib", "workers-runtime-sdk"]
+
+[tool.uv.sources]
+testlib = { path = "../packages/testlib" }
+workers-runtime-sdk = { path = "../packages/runtime-sdk" }

workers_runtime_sdk-1.9.2/tests/workerd-test/asgi/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "test"
+version = "0.0.0"
+requires-python = ">=3.12"
+dependencies = ["pytest", "pytest-asyncio<1.2.0", "testlib", "workers-runtime-sdk"]
+
+[tool.uv.sources]
+testlib = { path = "../packages/testlib" }
+workers-runtime-sdk = { path = "../packages/runtime-sdk" }

{workers_runtime_sdk-1.9.0 → workers_runtime_sdk-1.9.2}/tests/workerd-test/asgi/worker.py

@@ -1,28 +1,10 @@
-import asyncio
 import os
-import sys
 
-import pytest
-from pyodide.webloop import WebLoop
+from testlib.entrypoint import run_pytest
 
 import asgi
 from workers import WorkerEntrypoint
 
-
-async def noop(*args):
-    pass
-
-
-# pytest-asyncio relies on these but in Pyodide < 0.29 WebLoop does not implement them
-WebLoop.shutdown_asyncgens = noop
-WebLoop.shutdown_default_executor = noop
-
-# Pyodide 0.26.0a2's _cancel_all_tasks calls task.exception() on pending tasks,
-# which raises InvalidStateError under Pyodide's WebLoop.
-if sys.version_info < (3, 13):
-    asyncio.runners._cancel_all_tasks = lambda loop: None  # type: ignore[attr-defined]
-
-
 # ---------------------------------------------------------------------------
 # ASGI apps
 # ---------------------------------------------------------------------------
@@ -291,4 +273,4 @@ class Default(WorkerEntrypoint):
     async def test(self):
         os.chdir("/session/metadata/tests")
         args = [".", "-vv"]
-        assert pytest.main(args) == 0
+        run_pytest(args)

workers_runtime_sdk-1.9.2/tests/workerd-test/asgi-ws-disconnect/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "test"
+version = "0.0.0"
+requires-python = ">=3.12"
+dependencies = ["pytest", "pytest-asyncio<1.2.0", "testlib", "workers-runtime-sdk"]
+
+[tool.uv.sources]
+testlib = { path = "../packages/testlib" }
+workers-runtime-sdk = { path = "../packages/runtime-sdk" }