cfwtools 0.1.0__py3-none-any.whl

cfwtools/durable_object.py

@@ -0,0 +1,24 @@
+from functools import cached_property
+
+from workers import DurableObject as _DurableObject
+from cfwtools.sql import Sql
+
+if TYPE_CHECKING:
+    from js import DurableObjectState, Env
+
+
+class DurableObject(_DurableObject):
+    def __init__(self, ctx: "DurableObjectState", env: "Env") -> None:
+        super().__init__(ctx, env)
+        self.__post_init__()
+
+    @cached_property
+    def name(self) -> str:
+        return self.ctx.id.name
+
+    @cached_property
+    def sql(self) -> Sql:
+        return Sql(self.ctx.storage.sql)
+
+    def __post_init__(self) -> None:
+        pass

cfwtools/sql.py

@@ -0,0 +1,35 @@
+from typing import Any, Protocol, Iterator, Self
+from jinja2 import Template
+
+
+class _CursorRow(Protocol):
+    def to_py(self) -> dict[str, str]: ...
+
+
+class _CursorIterable(Protocol):
+    def __iter__(self) -> Iterator[_CursorRow]: ...
+
+
+class _SqlStorage(Protocol):
+    def exec(self, query: str, /, *bindings: Any) -> _CursorIterable: ...
+
+
+class Cursor:
+    def __init__(self, cursor: _CursorIterable) -> None:
+        self._iter = iter(cursor)
+
+    def __iter__(self) -> Self:
+        return self
+
+    def __next__(self) -> dict[str, str]:
+        return next(self._iter).to_py()
+
+
+class Sql:
+    def __init__(self, sql: _SqlStorage) -> None:
+        self._sql = sql
+
+    def __call__(self, query: str | Template, /, **values: Any) -> Cursor:
+        if isinstance(query, Template):
+            query = query.render(**values)
+        return Cursor(self._sql.exec(query))

cfwtools/template.py

@@ -0,0 +1,17 @@
+from jinja2 import Template, Environment, StrictUndefined, Undefined
+from typing import Any
+
+JINJA_ENV = Environment(undefined=StrictUndefined)
+
+
+def _safe_repr(value: Any) -> str | Undefined:
+    """Safely represent a value, preserving Undefined objects without conversion."""
+    return value if isinstance(value, Undefined) else repr(value)
+
+
+JINJA_ENV.filters["r"] = _safe_repr
+
+
+def template(source: str) -> Template:
+    """Create a Jinja2 template from a source string with strict undefined handling."""
+    return JINJA_ENV.from_string(source)

cfwtools-0.1.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.3
+Name: cfwtools
+Version: 0.1.0
+Summary: Cloudflare's Python Worker Development Tools
+Requires-Dist: workers-py>=1.12.0
+Requires-Dist: jinja2
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# cfwtools
+Cloudflare's Python Worker Development Tools

cfwtools-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+cfwtools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cfwtools/durable_object.py,sha256=JKQUskn5iDoQRuxx3flT-h1ztvZkA8_fT4jf70Hin4Q,577
+cfwtools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cfwtools/sql.py,sha256=L-FtnOk-ULpVgit8iWDcC0jH9kTPl8X7mBhauOfr1UM,876
+cfwtools/template.py,sha256=LGJ9PUAt8mB-5-6L9Y2XVS05FvngqlD7yEUcy4cwSRE,552
+cfwtools-0.1.0.dist-info/WHEEL,sha256=GuAqCqoyQuys5_R4zkHUJFlKXw4RpRLNzo31-ui90WQ,81
+cfwtools-0.1.0.dist-info/METADATA,sha256=CjA6JQgfWXVaDvD_Z7HA1pLyGrmZMjK2tJz8tFR8gHs,283
+cfwtools-0.1.0.dist-info/RECORD,,

cfwtools-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.10.12
+Root-Is-Purelib: true
+Tag: py3-none-any