workers-runtime-sdk 1.1.5__tar.gz → 1.2.0__tar.gz

workers_runtime_sdk-1.2.0/AGENTS.md

@@ -0,0 +1,23 @@
+# packages/runtime-sdk
+
+## Overview
+
+`workers-runtime-sdk` is a Python package that provides utilities for running Python code in a Cloudflare Worker environment.
+
+## Features
+
+This package provides utilities for:
+
+- Pythonic wrappers for Cloudflare Worker APIs
+- A simple ASGI server for running Python web applications in Cloudflare Workers
+
+## Development Guidelines
+
+- `_pyodide_entrypoint_helper` and `_cloudflare_compat_flags` are internal values that are imported from `workerd`.
+  - `workerd` (https://github.com/cloudflare/workerd) is the runtime that Cloudflare Workers use to run Python code.
+- When using a feature from `workerd`, always check if we can implement it in this package instead to avoid tight coupling with the runtime.
+
+## Testing
+
+- All the tests should be done inside `workerd`, not in the host environment.
+- Tests should be implemented in `../cli/tests` directory.

{workers_runtime_sdk-1.1.5 → workers_runtime_sdk-1.2.0}/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 <!-- version list -->
 
+## v1.2.0 (2026-06-12)
+
+### Features
+
+- Implements cf accessor on Request
+  ([`5777f80`](https://github.com/cloudflare/workers-py/commit/5777f80ead8d9a3c452fe3b6b8f2dc041d6c80d3))
+
+
+## v1.1.6 (2026-05-28)
+
+### Bug Fixes
+
+- Include asgi.py in the wheel ([#110](https://github.com/cloudflare/workers-py/pull/110),
+  [`cab6fab`](https://github.com/cloudflare/workers-py/commit/cab6fab48e63b05ac6d9b230c69657bde97eb0b8))
+
+
 ## v1.1.5 (2026-05-19)
 
 ### Bug Fixes

{workers_runtime_sdk-1.1.5 → workers_runtime_sdk-1.2.0}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "workers-runtime-sdk"
-version = "1.1.5"
+version = "1.2.0"
 description = "Python SDK for Cloudflare Workers"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -68,7 +68,7 @@ warn_unreachable = true
 no_implicit_optional = true
 
 [tool.hatch.build.targets.wheel]
-include = ["src/_*.py", "src/_*.pyi", "src/_*.pth", "src/workers"]
+include = ["src/*.py", "src/_*.pyi", "src/_*.pth", "src/workers"]
 
 [tool.hatch.build.targets.wheel.sources]
 "src" = ""

{workers_runtime_sdk-1.1.5 → workers_runtime_sdk-1.2.0}/src/workers/_workers.py

@@ -769,6 +769,20 @@ class Request:
     def body_used(self) -> bool:
         return self.js_object.bodyUsed
 
+    @property
+    def cf(self) -> "JsProxy | None":
+        """
+        Cloudflare-specific properties about the incoming request
+        (IncomingRequestCfProperties).  Access fields via attribute
+        notation, for example ``request.cf.colo``.
+
+        Returns None when not present (for example, in the dashboard/playground
+        preview or for requests constructed without a ``cf`` value).
+
+        See https://developers.cloudflare.com/workers/runtime-apis/request/#incomingrequestcfproperties
+        """
+        return _jsnull_to_none(self.js_object.cf)
+
     @property
     def cache(self) -> str:
         return self.js_object.cache