workers-runtime-sdk 1.4.2__tar.gz → 1.5.0__tar.gz

{workers_runtime_sdk-1.4.2 → workers_runtime_sdk-1.5.0}/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 <!-- version list -->
 
+## v1.5.0 (2026-06-23)
+
+### Features
+
+- Apply bindings wrapper to AI bindings ([#130](https://github.com/cloudflare/workers-py/pull/130),
+  [`79eeaf9`](https://github.com/cloudflare/workers-py/commit/79eeaf94ab02e4208372a7d3f57ba34248421c93))
+
+- Apply bindings wrapper to Images, RateLimit, and Analytics Engine
+  ([#130](https://github.com/cloudflare/workers-py/pull/130),
+  [`79eeaf9`](https://github.com/cloudflare/workers-py/commit/79eeaf94ab02e4208372a7d3f57ba34248421c93))
+
+- Wrap AI, Images, Analytics Engine, Vectorize and RateLimit Bindings to accept native Python
+  objects ([#130](https://github.com/cloudflare/workers-py/pull/130),
+  [`79eeaf9`](https://github.com/cloudflare/workers-py/commit/79eeaf94ab02e4208372a7d3f57ba34248421c93))
+
+
+## v1.4.3 (2026-06-18)
+
+### Bug Fixes
+
+- Ensure Worker subclasses are wrapped only once
+  ([#126](https://github.com/cloudflare/workers-py/pull/126),
+  [`af8ec42`](https://github.com/cloudflare/workers-py/commit/af8ec42eed1e2bbe6da1dbd537eb7a475f7071fb))
+
+
 ## v1.4.2 (2026-06-18)
 
 ### Bug Fixes

{workers_runtime_sdk-1.4.2 → workers_runtime_sdk-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workers-runtime-sdk
-Version: 1.4.2
+Version: 1.5.0
 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.4.2 → workers_runtime_sdk-1.5.0}/pyproject.toml

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

{workers_runtime_sdk-1.4.2 → workers_runtime_sdk-1.5.0}/src/workers/_workers.py

@@ -1313,6 +1313,13 @@ class _EnvWrapper:
         "R2Bucket",
         "D1Database",
         "WorkerQueue",
+        "Ai",
+        "VectorizeIndexImpl",
+        "AnalyticsEngineDataset",
+        "LocalAnalyticsEngineDataset",
+        "ImagesBindingImpl",
+        "HostedImagesBindingImpl",
+        "Ratelimit",
     }
 
     def __init__(self, env: Any):
@@ -1532,6 +1539,26 @@ async def _do_call(entrypoint, name, config, callback, *results):
     return result
 
 
+def _is_direct_binding_subclass(cls: type, binding_cls: type) -> bool:
+    """
+    Checks if the class is a direct subclass of the binding class.
+
+    In order to prevent applying the wrapper multiple times,
+    we only want to apply the wrapper if the class is directly inheriting
+    from the binding class, not if it's inheriting from another class that
+    inherits from the binding class.
+
+    Examples:
+    - `class A(DurableObject)` -> True
+    - `class B(A)` -> False
+    - `class C(B)` -> False
+    - `class D(C, DurableObject)` -> False
+    """
+    return not any(
+        issubclass(b, binding_cls) for b in cls.__bases__ if b is not binding_cls
+    )
+
+
 def _wrap_subclass(cls):
     # Override the class __init__ so that we can wrap the `env` in the constructor.
     original_init = cls.__init__
@@ -1590,7 +1617,8 @@ class DurableObject:
         self.env = env
 
     def __init_subclass__(cls, **_kwargs):
-        _wrap_subclass(cls)
+        if _is_direct_binding_subclass(cls, DurableObject):
+            _wrap_subclass(cls)
 
 
 class WorkerEntrypoint:
@@ -1606,8 +1634,9 @@ class WorkerEntrypoint:
         self.env = env
 
     def __init_subclass__(cls, **_kwargs: Any):
-        _wrap_subclass(cls)
-        _wrap_queue_handler(cls)
+        if _is_direct_binding_subclass(cls, WorkerEntrypoint):
+            _wrap_subclass(cls)
+            _wrap_queue_handler(cls)
 
 
 class WorkflowEntrypoint:
@@ -1623,8 +1652,9 @@ class WorkflowEntrypoint:
         self.env = env
 
     def __init_subclass__(cls, **_kwargs: Any):
-        _wrap_subclass(cls)
-        _wrap_workflow_step(cls)
+        if _is_direct_binding_subclass(cls, WorkflowEntrypoint):
+            _wrap_subclass(cls)
+            _wrap_workflow_step(cls)
 
 
 def _wrap_queue_handler(cls):