workers-runtime-sdk 1.4.1__tar.gz → 1.4.3__tar.gz

{workers_runtime_sdk-1.4.1 → workers_runtime_sdk-1.4.3}/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 <!-- version list -->
 
+## 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
+
+- Make iterables work correctly when returned from rpc call
+  ([#127](https://github.com/cloudflare/workers-py/pull/127),
+  [`36dc659`](https://github.com/cloudflare/workers-py/commit/36dc659d6ba394d75e3d11b3e78e2b08fcd91c9f))
+
+
 ## v1.4.1 (2026-06-18)
 
 ### Bug Fixes

{workers_runtime_sdk-1.4.1 → workers_runtime_sdk-1.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workers-runtime-sdk
-Version: 1.4.1
+Version: 1.4.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

{workers_runtime_sdk-1.4.1 → workers_runtime_sdk-1.4.3}/pyproject.toml

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

{workers_runtime_sdk-1.4.1 → workers_runtime_sdk-1.4.3}/src/workers/_workers.py

@@ -1122,6 +1122,14 @@ class _BindingWrapper:
     def __init__(self, binding):
         self._binding = binding
 
+    @property
+    def _real_name(self):
+        js_name = _get_js_constructor_name(self._binding)
+        if not js_name:
+            # Should not happen, but just in case
+            return type(self).__name__
+        return js_name
+
     def _should_wrap_nested_attribute(self, jsobj) -> bool:
         if not isinstance(jsobj, JsProxy):
             return False
@@ -1175,8 +1183,23 @@ class _BindingWrapper:
         return result
 
     def __getitem__(self, key):
+        if isinstance(key, int):
+            return self._convert_result(self._binding[key])
         return self._convert_result(getattr(self._binding, key))
 
+    def __iter__(self):
+        binding = self._binding
+        if not hasattr(binding, "__iter__"):
+            raise TypeError(f"'{self._real_name}' object is not iterable")
+        for item in binding:
+            yield self._convert_result(item)
+
+    def __len__(self):
+        binding = self._binding
+        if not hasattr(binding, "length"):
+            raise TypeError(f"'{self._real_name}' object has no len()")
+        return binding.length
+
 
 class _FetcherWrapper(_BindingWrapper):
     def fetch(self, *args, **kwargs):
@@ -1509,6 +1532,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__
@@ -1567,7 +1610,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:
@@ -1583,8 +1627,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:
@@ -1600,8 +1645,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):