weft-django 0.9.4__tar.gz

weft_django-0.9.4/.gitignore

@@ -0,0 +1,85 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.weft
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+.weft/broker.*
+.weft/config.json
+.weft/agents.json
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.coverage
+.coverage.*
+.pytest_cache/
+htmlcov/
+.tox/
+.nox/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.ruff_cache/
+.ruff/
+.pytest_cache/
+
+# SimpleBroker specific
+*.db-shm
+*.db-wal
+.broker.db*
+test.db
+benchmark_pragma.py
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.bak
+*.log
+
+# Multi-agent
+.claude
+.mcp.json
+agent_history/
+.broker.db
+.broker.db-shm
+.broker.db-wal
+.broker.connection.done
+.broker.connection.lock
+.broker.optimization.done
+.broker.optimization.lock
+*comments*.md
+.code/
+# This is in context for agents but we don't want it to check it in here
+simplebroker/

weft_django-0.9.4/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: weft-django
+Version: 0.9.4
+Summary: Django integration layer for Weft
+Author-email: Van Lindberg <van@modelmonster.ai>
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: django<6,>=4.2
+Requires-Dist: weft<1,>=0.9.4
+Provides-Extra: channels
+Requires-Dist: channels<5,>=4.1; extra == 'channels'
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# weft-django
+
+`weft-django` is the first-party Django integration for Weft.
+
+It provides:
+
+- `@weft_task` for Django-owned synchronous background functions
+- transaction-safe submission helpers such as `enqueue_on_commit()`
+- native TaskSpec, stored spec, and pipeline submission helpers
+- read-only Django URLs for task inspection
+- Django management commands for task status and control
+
+Install:
+
+```bash
+uv add weft-django
+```
+
+Or from the main package convenience extra:
+
+```bash
+uv add "weft[django]"
+```
+
+Basic usage:
+
+```python
+from weft_django import weft_task
+
+
+@weft_task(name="billing.send_invoice", timeout=60)
+def send_invoice(invoice_id: int) -> None:
+    ...
+
+
+submission = send_invoice.enqueue(123)
+submission.result(timeout=30)
+```
+
+Celery migration guide:
+
+| Celery habit | `weft-django` |
+| --- | --- |
+| `@shared_task` | `@weft_task` |
+| `task.delay(...)` | `task.enqueue(...)` |
+| `transaction.on_commit(lambda: task.delay(...))` | `task.enqueue_on_commit(...)` |
+
+`delay` and `shared_task` are intentionally not shipped. They are close enough
+to invite mechanical porting and far enough from Weft semantics to create
+delayed failures.

weft_django-0.9.4/README.md

@@ -0,0 +1,50 @@
+# weft-django
+
+`weft-django` is the first-party Django integration for Weft.
+
+It provides:
+
+- `@weft_task` for Django-owned synchronous background functions
+- transaction-safe submission helpers such as `enqueue_on_commit()`
+- native TaskSpec, stored spec, and pipeline submission helpers
+- read-only Django URLs for task inspection
+- Django management commands for task status and control
+
+Install:
+
+```bash
+uv add weft-django
+```
+
+Or from the main package convenience extra:
+
+```bash
+uv add "weft[django]"
+```
+
+Basic usage:
+
+```python
+from weft_django import weft_task
+
+
+@weft_task(name="billing.send_invoice", timeout=60)
+def send_invoice(invoice_id: int) -> None:
+    ...
+
+
+submission = send_invoice.enqueue(123)
+submission.result(timeout=30)
+```
+
+Celery migration guide:
+
+| Celery habit | `weft-django` |
+| --- | --- |
+| `@shared_task` | `@weft_task` |
+| `task.delay(...)` | `task.enqueue(...)` |
+| `transaction.on_commit(lambda: task.delay(...))` | `task.enqueue_on_commit(...)` |
+
+`delay` and `shared_task` are intentionally not shipped. They are close enough
+to invite mechanical porting and far enough from Weft semantics to create
+delayed failures.

weft_django-0.9.4/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "weft-django"
+version = "0.9.4"
+description = "Django integration layer for Weft"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "MIT"}
+authors = [
+    {name = "Van Lindberg", email = "van@modelmonster.ai"},
+]
+dependencies = [
+    "django>=4.2,<6",
+    "weft>=0.9.4,<1",
+]
+
+[project.optional-dependencies]
+channels = [
+    "channels>=4.1,<5",
+]
+dev = [
+    "pytest>=7.0",
+]
+
+[tool.hatch.build]
+include = [
+    "weft_django/**/*.py",
+    "README.md",
+]

weft_django-0.9.4/weft_django/__init__.py

@@ -0,0 +1,44 @@
+"""Public Django-facing Weft integration surface."""
+
+from __future__ import annotations
+
+from weft_django.client import (
+    DjangoWeftClient,
+    WeftDeferredSubmission,
+    WeftSubmission,
+    enqueue,
+    enqueue_on_commit,
+    get_client,
+    kill,
+    result,
+    status,
+    stop,
+    submit_pipeline_reference,
+    submit_pipeline_reference_on_commit,
+    submit_spec_reference,
+    submit_spec_reference_on_commit,
+    submit_taskspec,
+    submit_taskspec_on_commit,
+)
+from weft_django.decorators import RegisteredWeftTask, weft_task
+
+__all__ = [
+    "DjangoWeftClient",
+    "RegisteredWeftTask",
+    "WeftDeferredSubmission",
+    "WeftSubmission",
+    "enqueue",
+    "enqueue_on_commit",
+    "get_client",
+    "kill",
+    "result",
+    "status",
+    "stop",
+    "submit_pipeline_reference",
+    "submit_pipeline_reference_on_commit",
+    "submit_spec_reference",
+    "submit_spec_reference_on_commit",
+    "submit_taskspec",
+    "submit_taskspec_on_commit",
+    "weft_task",
+]

weft_django-0.9.4/weft_django/apps.py

@@ -0,0 +1,15 @@
+"""Django app config for the Weft integration."""
+
+from __future__ import annotations
+
+from django.apps import AppConfig
+
+from weft_django.registry import autodiscover_tasks
+
+
+class WeftDjangoConfig(AppConfig):
+    name = "weft_django"
+    verbose_name = "Weft Django"
+
+    def ready(self) -> None:
+        autodiscover_tasks()

weft_django-0.9.4/weft_django/channels.py

@@ -0,0 +1,26 @@
+"""Optional Channels integration for Weft task diagnostics."""
+
+from __future__ import annotations
+
+from django.core.exceptions import ImproperlyConfigured
+
+try:
+    from channels.generic.websocket import AsyncJsonWebsocketConsumer
+except ImportError as exc:  # pragma: no cover - import guard
+    raise ImproperlyConfigured(
+        "Channels support requires installing weft-django with the 'channels' extra"
+    ) from exc
+
+
+class TaskEventsConsumer(AsyncJsonWebsocketConsumer):  # pragma: no cover - optional
+    async def connect(self) -> None:
+        await self.accept()
+        await self.send_json(
+            {
+                "event_type": "end",
+                "payload": {
+                    "detail": "Use the default SSE transport in v1 unless the project provides a custom Channels consumer."
+                },
+            }
+        )
+        await self.close()