workers-runtime-sdk 1.9.1__tar.gz → 1.9.3__tar.gz

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/.gitignore

@@ -45,6 +45,7 @@ htmcov/
 nosetests.xml
 coverage.xml
 *.cover
+*.profraw
 .hypothesis/
 .pytest_cache/
 
@@ -62,5 +63,6 @@ docs/_build/
 # OS specific
 .DS_Store
 Thumbs.db
+default.profraw
 
 tests/test_workspace

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 <!-- version list -->
 
+## v1.9.3 (2026-10-06)
+
+### Bug Fixes
+
+- Unify license to MIT and include license file in dists
+  ([#285](https://github.com/cloudflare/workers-py/pull/285),
+  [`253f3d5`](https://github.com/cloudflare/workers-py/commit/253f3d5bb9194023a9dfcc7da6051df2964b628b))
+
+
+## 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

workers_runtime_sdk-1.9.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cloudflare, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/PKG-INFO

@@ -1,9 +1,11 @@
 Metadata-Version: 2.5
 Name: workers-runtime-sdk
-Version: 1.9.1
+Version: 1.9.3
 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
+License-Expression: MIT
+License-File: LICENSE
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/pyproject.toml

@@ -4,9 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "workers-runtime-sdk"
-version = "1.9.1"
+version = "1.9.3"
 description = "Python SDK for Cloudflare Workers"
 readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
 requires-python = ">=3.11"
 classifiers = [
     "Programming Language :: Python :: 3",

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/src/_workers_sdk_entropy_import_context.py

@@ -229,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.1 → workers_runtime_sdk-1.9.3}/tests/conftest.py

@@ -1,8 +1,5 @@
 """Shared fixtures and helpers for the host-side test suite."""
 
-import os
-import shutil
-from collections.abc import Generator
 from pathlib import Path
 from typing import Any
 
@@ -10,20 +7,17 @@ import pytest
 from testlib.host import (
     COMPAT_CONFIGS,
     CompatConfig,
-    configure_compatibility,
-    link_packages,
-    pywrangler_sync,
-)
-from testlib.host import (
-    dev_server as run_dev_server,
+    dev_server,
 )
 from testlib.host import (
     register_in_worker_suites as register_testlib_suites,
 )
 
+__all__ = ["dev_server"]
+
+
 TEST_DIR: Path = Path(__file__).parent
 
-DEV_STARTUP_TIMEOUT: int = 120
 OPT_IN_MARKERS: tuple[str, ...] = ("hyperdrive",)
 
 
@@ -62,38 +56,8 @@ def worker_project_dir() -> Path:
 
 
 @pytest.fixture(scope="module")
-def dev_server(
-    tmp_path_factory: pytest.TempPathFactory,
-    worker_project_dir: Path,
-    compat_config: CompatConfig,
-) -> Generator[str]:
-    """Start a pywrangler dev server on a free port and yield its base URL.
-
-    The project is copied next to a ``packages`` symlink so that its
-    ``../packages/...`` sources resolve and ``sync`` vendors the working-tree
-    testlib and runtime-sdk.
-    """
-    tmp_path = tmp_path_factory.mktemp(f"{worker_project_dir.name}_dev")
-    target = tmp_path / worker_project_dir.name
-    shutil.copytree(worker_project_dir, target, ignore=shutil.ignore_patterns(".venv"))
-    link_packages(tmp_path)
-    env = os.environ | {"_PYODIDE_EXTRA_MOUNTS": str(tmp_path)}
-
-    wrangler_jsonc = target / "wrangler.jsonc"
-    configure_compatibility(wrangler_jsonc, compat_config)
-
-    pywrangler_sync(target, env)
-
-    with run_dev_server(
-        target,
-        tmp_path,
-        env,
-        startup_timeout=DEV_STARTUP_TIMEOUT,
-        readiness_path="/health",
-        require_success=True,
-        log_name="dev.log",
-    ) as (base_url, _):
-        yield base_url
+def dev_startup_timeout():
+    return 120
 
 
 def register_in_worker_suites(

workers_runtime_sdk-1.9.3/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.1 → workers_runtime_sdk-1.9.3}/tests/test_in_workerd.py

@@ -7,6 +7,8 @@ import pytest
 from conftest import (
     COMPAT_CONFIGS,
     CompatConfig,
+)
+from testlib.host import (
     configure_compatibility,
     link_packages,
     pywrangler_sync,

workers_runtime_sdk-1.9.3/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.3/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.3/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.3/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.3/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.3/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.3/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.1 → workers_runtime_sdk-1.9.3}/tests/workerd-test/durable-object/worker.py

@@ -1,7 +1,3 @@
-# Copyright (c) 2023 Cloudflare, Inc.
-# Licensed under the Apache 2.0 license found in the LICENSE file or at:
-#     https://opensource.org/licenses/Apache-2.0
-
 # Copied from: https://github.com/cloudflare/workerd/tree/main/src/workerd/server/tests/python/durable-object
 
 from asyncio import sleep

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/tests/workerd-test/durable-object-abort/worker.py

@@ -1,6 +1,3 @@
-# Copyright (c) 2026 Cloudflare, Inc.
-# Licensed under the Apache 2.0 license found in the LICENSE file or at:
-#     https://opensource.org/licenses/Apache-2.0
 from unittest import TestCase
 
 from workers import DurableObject, Response, WorkerEntrypoint

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/tests/workerd-test/durable-object-websocket/tester.js

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Cloudflare, Inc.
-// Licensed under the Apache 2.0 license found in the LICENSE file or at:
-//     https://opensource.org/licenses/Apache-2.0
 export default {
   async test(ctrl, env, ctx) {
     const resp = await env.PYTHON.fetch('http://example.com/websocket', {

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/tests/workerd-test/durable-object-websocket/worker.py

@@ -1,7 +1,3 @@
-# Copyright (c) 2023 Cloudflare, Inc.
-# Licensed under the Apache 2.0 license found in the LICENSE file or at:
-#     https://opensource.org/licenses/Apache-2.0
-
 # Copied from: https://github.com/cloudflare/workerd/tree/main/src/workerd/server/tests/python/durable-object-websocket
 from js import WebSocketPair
 

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/tests/workerd-test/python-rpc/worker.js

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Cloudflare, Inc.
-// Licensed under the Apache 2.0 license found in the LICENSE file or at:
-//     https://opensource.org/licenses/Apache-2.0
 import { WorkerEntrypoint } from 'cloudflare:workers';
 
 import * as assert from 'node:assert';

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/tests/workerd-test/python-rpc/worker.py

@@ -1,7 +1,3 @@
-# Copyright (c) 2023 Cloudflare, Inc.
-# Licensed under the Apache 2.0 license found in the LICENSE file or at:
-#     https://opensource.org/licenses/Apache-2.0
-
 # Ported from workerd (https://github.com/cloudflare/workerd/tree/main/src/workerd/server/tests/python/python-rpc)
 
 import collections.abc

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/tests/workerd-test/workflow/worker.js

@@ -1,6 +1,3 @@
-// Copyright (c) 2026 Cloudflare, Inc.
-// Licensed under the Apache 2.0 license found in the LICENSE file or at:
-//     https://opensource.org/licenses/Apache-2.0
 import { RpcTarget } from 'cloudflare:workers';
 
 import * as assert from 'node:assert';

{workers_runtime_sdk-1.9.1 → workers_runtime_sdk-1.9.3}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 5
 requires-python = ">=3.11"
 
 [[package]]
@@ -376,7 +376,7 @@ wheels = [
 
 [[package]]
 name = "workers-runtime-sdk"
-version = "1.9.1"
+version = "1.9.3"
 source = { editable = "." }
 
 [package.dev-dependencies]