queueio 0.5.0__tar.gz → 0.6.0__tar.gz

queueio-0.6.0/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv python install 3.14t
+      - run: uv sync --group dev
+      - run: uv run mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+      - id: deployment
+        uses: actions/deploy-pages@v4

{queueio-0.5.0 → queueio-0.6.0}/.gitignore

@@ -15,3 +15,6 @@ uv.lock
 .python-version
 .ruff_cache/
 .ropeproject/
+
+# MkDocs
+site/

{queueio-0.5.0 → queueio-0.6.0}/CHANGELOG.md

@@ -8,6 +8,16 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com).
 [Unreleased]
 ------------
 
+[0.6.0] - 2026-02-16
+--------------------
+
+### Added
+
+- Django integration (`queueio.django`) with `runserver` lifecycle management.
+- [djp](https://djp.readthedocs.io/) support for automatic `INSTALLED_APPS` registration.
+- [django-cmd](https://pypi.org/project/django-cmd/) integration for settings discovery.
+- Documentation site.
+
 [0.5.0] - 2026-02-08
 --------------------
 
@@ -96,7 +106,8 @@ Thank you to Nick Anderegg for allowing me to use the queueio name for this proj
 - The queuespec syntax to `queue run` to consume multiple queues with shared capacity.
 - `queueio monitor` command to monitor activity in the queueio system.
 
-[Unreleased]: https://github.com/ryanhiebert/queueio/compare/tag/0.5.0...HEAD
+[Unreleased]: https://github.com/ryanhiebert/queueio/compare/tag/0.6.0...HEAD
+[0.6.0]: https://github.com/ryanhiebert/queueio/compare/tag/0.5.0...tag/0.6.0
 [0.5.0]: https://github.com/ryanhiebert/queueio/compare/tag/0.4.0...tag/0.5.0
 [0.4.0]: https://github.com/ryanhiebert/queueio/compare/tag/0.3.0...tag/0.4.0
 [0.3.0]: https://github.com/ryanhiebert/queueio/compare/tag/0.2.2...tag/0.3.0

queueio-0.6.0/CNAME

@@ -0,0 +1 @@
+queueio.dev

{queueio-0.5.0 → queueio-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: queueio
-Version: 0.5.0
+Version: 0.6.0
 Summary: Python background queues with an async twist
 Author-email: Ryan Hiebert <ryan@ryanhiebert.com>
 License-Expression: MIT
@@ -18,6 +18,9 @@ Requires-Dist: dill>=0.3.9
 Requires-Dist: pika>=1.3.2
 Requires-Dist: textual>=3.2.0
 Requires-Dist: typer>=0.15.4
+Provides-Extra: django
+Requires-Dist: django-cmd>=3.0; extra == 'django'
+Requires-Dist: django>=6.0; extra == 'django'
 Description-Content-Type: text/markdown
 
 ![queueio](https://raw.githubusercontent.com/ryanhiebert/queueio/main/logo.svg)

queueio-0.6.0/docs_overrides/assets/images/favicon.svg

@@ -0,0 +1 @@
+<svg width="128" height="128" viewBox="100 400 520 720" xmlns="http://www.w3.org/2000/svg"><path d="M338.012,467.371c55.9,-7.825 112.888,7.725 154.194,46.346l1.633,-34.906l110.412,0.348l0.429,621.113l-119.094,0.729l0.14,-84.292c0.581,-38.062 0.669,-76.146 0.262,-114.229c-26.765,20.792 -52.321,33.083 -86.125,38.792c-59.756,9.646 -120.892,-4.896 -169.906,-40.417c-123.606,-89.792 -124.921,-294.833 -5.21,-388.29c33.813,-26.398 71.26,-39.381 113.265,-45.194Zm19.171,112.15c-155.729,31.208 -124.015,270.292 35.14,252.375c31.623,-7.125 63.613,-22.396 78.979,-52c48.587,-93.646 0.254,-206.665 -114.119,-200.375Z" fill="#0384d3"/></svg>

queueio-0.6.0/docs_overrides/assets/stylesheets/extra.css

@@ -0,0 +1,7 @@
+.md-header__topic {
+    display: none;
+}
+
+.md-nav--primary > .md-nav__title {
+    display: none;
+}

queueio-0.6.0/docs_overrides/partials/javascripts/palette.html

@@ -0,0 +1,47 @@
+<script>
+  (function () {
+    // Remove any cached palette so Material always re-evaluates media queries
+    try {
+      var key = __md_scope.pathname + ".__palette";
+      localStorage.removeItem(key);
+    } catch (e) {}
+
+    // Prevent Material from persisting palette choices
+    var origSet = __md_set;
+    __md_set = function (k) {
+      if (k === "__palette") return;
+      return origSet.apply(this, arguments);
+    };
+
+    function apply() {
+      var inputs = document.querySelectorAll("[data-md-color-media]");
+      for (var i = 0; i < inputs.length; i++) {
+        var media = inputs[i].getAttribute("data-md-color-media");
+        if (media && matchMedia(media).matches) {
+          document.body.setAttribute(
+            "data-md-color-scheme",
+            inputs[i].getAttribute("data-md-color-scheme"),
+          );
+          document.body.setAttribute(
+            "data-md-color-primary",
+            inputs[i].getAttribute("data-md-color-primary"),
+          );
+          document.body.setAttribute(
+            "data-md-color-accent",
+            inputs[i].getAttribute("data-md-color-accent"),
+          );
+          break;
+        }
+      }
+    }
+
+    if (document.body) apply();
+    document.addEventListener("DOMContentLoaded", apply);
+
+    // Listen on both light and dark queries for maximum compatibility
+    var dark = matchMedia("(prefers-color-scheme: dark)");
+    var light = matchMedia("(prefers-color-scheme: light)");
+    dark.addEventListener("change", apply);
+    light.addEventListener("change", apply);
+  })();
+</script>

queueio-0.6.0/logo.svg

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg width="100%" height="100%" viewBox="0 0 3750 1250" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><path d="M338.012,467.371c55.9,-7.825 112.888,7.725 154.194,46.346l1.633,-34.906l110.412,0.348l0.429,621.113l-119.094,0.729l0.14,-84.292c0.581,-38.062 0.669,-76.146 0.262,-114.229c-26.765,20.792 -52.321,33.083 -86.125,38.792c-59.756,9.646 -120.892,-4.896 -169.906,-40.417c-123.606,-89.792 -124.921,-294.833 -5.21,-388.29c33.813,-26.398 71.26,-39.381 113.265,-45.194Zm19.171,112.15c-155.729,31.208 -124.015,270.292 35.14,252.375c31.623,-7.125 63.613,-22.396 78.979,-52c48.587,-93.646 0.254,-206.665 -114.119,-200.375Z" style="fill:#0384d3;"/><path d="M3268.646,460.052c134.458,-6.86 249.125,96.36 256.396,230.802c7.271,134.438 -95.604,249.417 -230.021,257.104c-135,7.708 -250.583,-95.708 -257.896,-230.729c-7.292,-135.021 96.458,-250.287 231.521,-257.177Zm2.479,120.469c-68.125,5.438 -118.958,65.021 -113.625,133.146c5.354,68.125 64.854,119.063 133,113.813c68.271,-5.271 119.312,-64.917 113.958,-133.167c-5.354,-68.271 -65.083,-119.229 -133.333,-113.792Z" style="fill:#f36c17;"/><path d="M2429.667,469.504c12.625,-1.277 25.333,-1.637 38,-1.077c58.917,2.092 114.5,27.933 154.062,71.644c52.979,58.929 65.167,125.804 61.271,202.013c-112.188,0.062 -236.083,-2.688 -347.25,0.688c33.104,99.271 122.188,114.187 212.771,76.75c14.417,-5.958 26.458,-14.292 39.333,-23.104l19.854,17.875c17.688,15.375 35.479,30.604 53.417,45.667c-45.021,45.646 -88.25,70.958 -151.542,80.979c-136.083,21.812 -272.917,-55.979 -289.583,-199.979c-16.167,-139.792 69.271,-254.075 209.667,-271.454Zm6.521,105.933c-53.875,11.125 -79.604,36.646 -97.854,87l131.833,0l93.062,-0.021c-20.5,-65.292 -58.521,-91.863 -127.042,-86.979Z" style="fill:#0384d3;"/><path d="M1393.312,469.496c13.946,-1.45 27.981,-1.844 41.985,-1.177c124.958,6.165 211.754,108.598 215.608,230.931c0.454,14.458 -0.396,28.729 -1.135,43.146c-113.421,0.146 -233.358,-1.979 -346.019,0.917c35.075,119.604 166.117,114.438 252.931,54.021l19.162,16.812l52.948,45.75c-93.298,94.875 -235.873,114.75 -348.002,38.292c-108.408,-73.938 -123.404,-237.167 -46.944,-338.815c39.348,-52.308 95.038,-80.494 159.465,-89.877Zm11.287,106.067c-52.808,10.479 -81.34,36.708 -98.487,87.188l128.262,-0.188l95.665,0.021c-20.037,-66.396 -57.262,-91.356 -125.44,-87.021Z" style="fill:#0384d3;"/><path d="M2024.729,479.54l116.958,-0.354l0.021,138.523l-0.167,311.458l-108.396,-0.312c-0.146,-11.854 -0.792,-24.396 -1.208,-36.292c-9.125,8.25 -18.333,16.771 -28.583,23.604c-67.708,45.271 -173.667,36.542 -231.077,-21.188c-20.035,-20.333 -34.302,-45.604 -41.333,-73.271c-11.271,-42.875 -8.121,-116.021 -8.058,-162.333l-0.331,-180.123l117.487,0.158c0.854,63.542 -0.438,127.694 0.25,191.319c0.729,34.896 -1.833,68.792 3.146,103.437c9.833,72.146 114.625,83.875 158.271,37.771c31.292,-33.042 23.438,-107.792 23.417,-150.979l-0.396,-181.419Z" style="fill:#0384d3;fill-rule:nonzero;"/><path d="M994.065,479.233l117.913,-0.075l0.004,138.404l0.092,311.167c-36.994,-0.792 -73.996,-1.208 -111,-1.229l-0.89,-34.312c-37.987,35.167 -67.31,49.958 -120.646,51.5c-48.3,1.417 -96.542,-13.354 -131.633,-47.625c-21.715,-21.229 -37.135,-48.062 -44.563,-77.542c-9.981,-38.771 -7.425,-111.354 -7.448,-154.083l-0.317,-186.194l116.79,0.156l0.242,182.517c0.017,35.979 -2.15,80.188 3.8,114.854c14.915,86.896 161.917,80.75 174.977,-4.979c5.375,-35.271 3.119,-75.542 3.006,-111.167l-0.327,-181.392Z" style="fill:#0384d3;fill-rule:nonzero;"/><path d="M2915.604,464.727c6.417,0.619 11.042,0.294 16.167,4.017c2.625,12.019 1.146,114.131 1.083,136.027l0.208,324.417l-125.042,0.062l-0.167,-39.146l0.188,-258.479c-20.562,0.042 -39.271,0.104 -59.875,1.292c30.375,-33.896 68,-66.692 100.604,-99.329c20.229,-20.242 46.75,-51.537 66.833,-68.86Z" style="fill:#f36c17;fill-rule:nonzero;"/><path d="M2859.583,240.567c42.292,-5.871 81.313,23.763 87.021,66.09c5.688,42.329 -24.104,81.225 -66.437,86.752c-42.125,5.496 -80.75,-24.088 -86.417,-66.175c-5.667,-42.085 23.771,-80.831 65.833,-86.667Z" style="fill:#f36c17;fill-rule:nonzero;"/></svg>

queueio-0.6.0/mkdocs.yml

@@ -0,0 +1,41 @@
+site_name: queueio
+site_description: Python background queues with an async twist
+site_url: https://queueio.dev/
+repo_url: https://github.com/ryanhiebert/queueio
+repo_name: ryanhiebert/queueio
+
+docs_dir: .
+
+theme:
+  name: material
+  custom_dir: docs_overrides
+  logo: assets/images/logo.svg
+  favicon: assets/images/favicon.svg
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: white
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: black
+
+markdown_extensions:
+  - admonition
+  - pymdownx.highlight
+  - pymdownx.superfences
+
+extra_css:
+  - assets/stylesheets/extra.css
+
+plugins:
+  - search
+  - same-dir
+
+nav:
+  - Home: README.md
+  - Philosophy: philosophy.md
+  - Invocation: queueio/invocation.md
+  - QueueSpec: queueio/queuespec.md
+  - QueueVar: queueio/queuevar.md
+  - Django: queueio/django.md
+  - Changelog: CHANGELOG.md

queueio-0.5.0/principles.md → queueio-0.6.0/philosophy.md

@@ -1,4 +1,4 @@
-Principles
+Philosophy
 ==========
 
 There's been a great deal of momentum to embrace async functions for IO,

{queueio-0.5.0 → queueio-0.6.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "queueio"
-version = "0.5.0"
+version = "0.6.0"
 description = "Python background queues with an async twist"
 readme = "README.md"
 license = "MIT"
-homepage = "https://github.com/ryanhiebert/queueio"
+homepage = "https://queueio.dev/"
 repository = "https://github.com/ryanhiebert/queueio"
 authors = [
     { name = "Ryan Hiebert", email = "ryan@ryanhiebert.com" },
@@ -27,12 +27,23 @@ dependencies = [
     "typer>=0.15.4",
 ]
 
+[project.optional-dependencies]
+django = ["django>=6.0", "django-cmd>=3.0"]
+
+[project.entry-points.djp]
+queueio = "queueio.django.djp"
+
 [project.scripts]
 queueio = "queueio.__main__:app"
 
 [dependency-groups]
 dev = [
     "basedpyright>=1.32.1",
+    "django-extensions",
+    "djp",
+    "queueio[django]",
+    "mkdocs-material>=9.7.1",
+    "mkdocs-same-dir>=0.1.3",
     "pytest>=8.4.1",
     "pytest-cov>=6.0.0",
     "pytest-timeout>=2.4.0",
@@ -58,6 +69,7 @@ pika = "amqp://localhost:5672"
 
 [tool.pytest.ini_options]
 timeout = 30
+norecursedirs = ["site"]
 
 [tool.coverage.run]
 branch = true

queueio-0.6.0/queueio/django/__init__.py

@@ -0,0 +1,17 @@
+import os
+
+
+def setup():
+    try:
+        from django_cmd import configure
+
+        configure()
+    except ImportError:
+        pass
+
+    if "DJANGO_SETTINGS_MODULE" not in os.environ:
+        return
+
+    import django
+
+    django.setup()

queueio-0.6.0/queueio/django/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class QueueIOConfig(AppConfig):
+    name = "queueio.django"
+    label = "queueio"

queueio-0.6.0/queueio/django/djp.py

@@ -0,0 +1,6 @@
+import djp
+
+
+@djp.hookimpl
+def installed_apps():
+    return ["queueio.django"]

queueio-0.6.0/queueio/django/management/commands/runserver.py

@@ -0,0 +1,41 @@
+import tomllib
+from importlib import import_module
+from pathlib import Path
+
+
+def _find_pyproject() -> Path | None:
+    for path in [cwd := Path.cwd(), *cwd.parents]:
+        candidate = path / "pyproject.toml"
+        if candidate.is_file():
+            return candidate
+    return None
+
+
+def _queueio_django_config() -> dict:
+    if pyproject := _find_pyproject():
+        with pyproject.open("rb") as f:
+            config = tomllib.load(f)
+        return config.get("tool", {}).get("queueio", {}).get("django", {})
+    return {}
+
+
+def _resolve_base_command(config: dict):
+    runserver_app = config.get("runserver", "django.core")
+    module = import_module(f"{runserver_app}.management.commands.runserver")
+    return module.Command
+
+
+def _build_command():
+    base = _resolve_base_command(_queueio_django_config())
+
+    class Command(base):
+        def inner_run(self, *args, **options):
+            from queueio import activate
+
+            with activate():
+                super().inner_run(*args, **options)
+
+    return Command
+
+
+Command = _build_command()

queueio-0.6.0/queueio/django/management/commands/runserver_plus.py

@@ -0,0 +1,9 @@
+from django_extensions.management.commands.runserver_plus import Command as BaseCommand
+
+from queueio import activate
+
+
+class Command(BaseCommand):
+    def inner_run(self, options):
+        with activate():
+            super().inner_run(options)

queueio-0.6.0/queueio/django/runserver_test.py

@@ -0,0 +1,63 @@
+import os
+import sysconfig
+
+import pytest
+
+from .management.commands.runserver import _build_command
+
+
+@pytest.mark.parametrize(
+    ("runserver_app", "expected_module"),
+    [
+        pytest.param(
+            None,
+            "django.core.management.commands.runserver",
+            id="default",
+        ),
+        pytest.param(
+            "django.contrib.staticfiles",
+            "django.contrib.staticfiles.management.commands.runserver",
+            id="staticfiles",
+        ),
+        pytest.param(
+            "daphne",
+            "daphne.management.commands.runserver",
+            id="daphne",
+            marks=pytest.mark.skipif(
+                bool(sysconfig.get_config_var("Py_GIL_DISABLED")),
+                reason="zope.interface re-enables the GIL on free-threaded builds",
+            ),
+        ),
+    ],
+)
+def test_runserver(tmp_path, runserver_app, expected_module):
+    config = "[tool.queueio]\n"
+    if runserver_app is not None:
+        config = f'[tool.queueio.django]\nrunserver = "{runserver_app}"\n'
+
+    pyproject = tmp_path / "pyproject.toml"
+    pyproject.write_text(config)
+
+    original_cwd = os.getcwd()
+    os.chdir(tmp_path)
+    try:
+        Cmd = _build_command()
+        from importlib import import_module
+
+        expected = import_module(expected_module)
+        assert issubclass(Cmd, expected.Command)
+    finally:
+        os.chdir(original_cwd)
+
+
+def test_runserver_plus():
+    from django.conf import settings
+
+    if not settings.configured:
+        settings.configure()
+
+    from django_extensions.management.commands import runserver_plus as expected
+
+    from .management.commands.runserver_plus import Command
+
+    assert issubclass(Command, expected.Command)

queueio-0.6.0/queueio/django.md

@@ -0,0 +1,82 @@
+# Django Integration
+
+## Settings
+
+When running `queueio run`,
+Django isn't started automatically.
+If your routines use the Django ORM or other Django features,
+queueio needs to call `django.setup()` before importing routine modules.
+
+The `queueio[django]` extra includes
+[django-cmd](https://pypi.org/project/django-cmd/),
+which reads `tool.django.settings` from `pyproject.toml`
+and sets `DJANGO_SETTINGS_MODULE` automatically:
+
+```toml
+[tool.django]
+settings = "myproject.settings"
+```
+
+If `DJANGO_SETTINGS_MODULE` is set in the environment
+(whether by `django-cmd` or directly),
+queueio calls `django.setup()` before registering routines.
+
+## Runserver
+
+!!! warning "Development server only"
+
+    The runserver integration only affects the `runserver` management command.
+    Production servers like gunicorn need their own lifecycle hooks.
+
+queueio ships a Django app
+that overrides the `runserver` management command
+to wrap the server in `with activate():`,
+giving you automatic lifecycle management
+of the broker connection and background threads
+during development.
+
+### Setup
+
+If you use [djp](https://djp.readthedocs.io/),
+`queueio.django` is added to `INSTALLED_APPS` automatically.
+
+Otherwise, add it manually:
+
+```python
+INSTALLED_APPS = [
+    "queueio.django",
+    # ...
+]
+```
+
+This must come **after** whichever app provides the `runserver` command
+you want to chain with
+(e.g. `daphne`, `django.contrib.staticfiles`),
+because Django resolves management commands by last-app-wins order.
+
+### Custom provider
+
+If you use a custom `runserver` provider
+like `django.contrib.staticfiles` or `daphne`,
+tell queueio which app to chain with:
+
+```toml
+[tool.queueio.django]
+runserver = "daphne"
+```
+
+The value is the app label (or dotted module path).
+queueio resolves it to `{value}.management.commands.runserver`
+and subclasses that command.
+If omitted, it defaults to Django's built-in `runserver`.
+
+### `runserver_plus`
+
+There is also a built-in `runserver_plus` command
+that wraps [django-extensions](https://django-extensions.readthedocs.io/)' `runserver_plus`
+with `activate()`.
+This is available automatically
+when `django-extensions` is installed
+and `queueio.django` is in `INSTALLED_APPS`.
+
+A complete working example is in `queueio/samples/django/`.

{queueio-0.5.0 → queueio-0.6.0}/queueio/freethreading_test.py

@@ -22,7 +22,7 @@ def test_all_queueio_modules_preserve_freethreading():
     for _, modname, _ in pkgutil.walk_packages(
         queueio.__path__, f"{queueio.__name__}."
     ):
-        if not modname.endswith("_test"):
+        if not modname.endswith("_test") and ".django" not in modname:
             importlib.import_module(modname)
 
     assert sys._is_gil_enabled() is False

{queueio-0.5.0 → queueio-0.6.0}/queueio/queueio.py

@@ -11,6 +11,7 @@ from typing import Self
 
 from .broker import Broker
 from .consumer import Consumer
+from .django import setup as _django_setup
 from .invocation import Invocation
 from .journal import Journal
 from .message import Message
@@ -105,6 +106,9 @@ class QueueIO:
 
     def __register_routines(self):
         """Load routine modules from pyproject.toml."""
+        for hook in [_django_setup]:
+            hook()
+
         config = self.__config()
         modules = config.get("register", [])
 

queueio-0.6.0/queueio/samples/django/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class QueueIOSampleConfig(AppConfig):
+    name = "queueio.samples.django"
+    label = "queueio_sample"

queueio-0.6.0/queueio/samples/django/job.py

@@ -0,0 +1,29 @@
+from django.db import models
+from django.http import JsonResponse
+
+from queueio import routine
+
+
+class Job(models.Model):
+    status = models.CharField(max_length=20, default="pending")
+    objects = models.Manager()  # pyright: ignore[reportAssignmentType]
+
+    class Meta:
+        app_label = "queueio_sample"
+
+
+@routine(name="update_job", queue="django")
+def update_job(job_id: int):
+    job = Job.objects.get(pk=job_id)
+    job.status = "complete"
+    job.save()
+
+
+def index(request):
+    if request.method == "POST":
+        job = Job.objects.create()
+        update_job(job.pk).submit()
+        return JsonResponse({"job_id": job.pk, "status": job.status})
+
+    job = Job.objects.latest("pk")
+    return JsonResponse({"job_id": job.pk, "status": job.status})

queueio-0.6.0/queueio/samples/django/models.py

@@ -0,0 +1,3 @@
+from .job import Job
+
+__all__ = ["Job"]

queueio-0.6.0/queueio/samples/django/settings.py

@@ -0,0 +1,19 @@
+DEBUG = True
+
+SECRET_KEY = "insecure-example-key"
+
+INSTALLED_APPS = [
+    "queueio.django",
+    "queueio.samples.django",
+]
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": "db.sqlite3",
+    }
+}
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+
+ROOT_URLCONF = "queueio.samples.django.urls"

queueio-0.6.0/queueio/samples/django/settings_djp.py

@@ -0,0 +1,24 @@
+import djp
+
+DEBUG = True
+
+SECRET_KEY = "insecure-example-key"
+
+INSTALLED_APPS = [
+    "queueio.samples.django",
+]
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": "db.sqlite3",
+    }
+}
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+
+ROOT_URLCONF = "queueio.samples.django.urls"
+
+MIDDLEWARE = []
+
+djp.settings(globals())

queueio-0.6.0/queueio/samples/django/urls.py

@@ -0,0 +1,7 @@
+from django.urls import path
+
+from .job import index
+
+urlpatterns = [
+    path("", index),
+]

queueio-0.6.0/queueio/samples/django_test.py

@@ -0,0 +1,98 @@
+import json
+import os
+import socket
+import subprocess
+import sys
+import time
+from urllib.request import Request
+from urllib.request import urlopen
+
+import pytest
+
+
+def _wait_for_port(port, timeout=10):
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        try:
+            with socket.create_connection(("127.0.0.1", port), timeout=0.1):
+                return
+        except OSError:
+            time.sleep(0.1)
+    raise TimeoutError(f"Port {port} not ready")
+
+
+@pytest.mark.timeout(10)
+@pytest.mark.parametrize(
+    "settings",
+    [
+        pytest.param("queueio.samples.django.settings", id="explicit"),
+        pytest.param("queueio.samples.django.settings_djp", id="djp"),
+    ],
+)
+def test_django(tmp_path, settings):
+    env = {**os.environ, "DJANGO_SETTINGS_MODULE": settings}
+
+    pyproject = tmp_path / "pyproject.toml"
+    pyproject.write_text(
+        f"[tool.django]\n"
+        f'settings = "{settings}"\n'
+        f"\n"
+        f"[tool.queueio]\n"
+        f'register = ["queueio.samples.django.job"]\n'
+        f'pika = "amqp://localhost:5672"\n'
+    )
+
+    subprocess.run(
+        [sys.executable, "-m", "django", "migrate", "--run-syncdb"],
+        cwd=str(tmp_path),
+        env=env,
+        check=True,
+        capture_output=True,
+    )
+
+    subprocess.run(
+        [sys.executable, "-m", "queueio", "sync"],
+        cwd=str(tmp_path),
+        env=env,
+        check=True,
+        capture_output=True,
+    )
+
+    server = subprocess.Popen(
+        [sys.executable, "-m", "django", "runserver", "--noreload", "127.0.0.1:8642"],
+        cwd=str(tmp_path),
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+    worker = subprocess.Popen(
+        [sys.executable, "-m", "queueio", "run", "django=1"],
+        cwd=str(tmp_path),
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+
+    try:
+        _wait_for_port(8642)
+
+        urlopen(Request("http://127.0.0.1:8642/", method="POST"))
+
+        while True:
+            assert worker.poll() is None, (
+                f"Worker exited early with code {worker.returncode}"
+            )
+            response = urlopen("http://127.0.0.1:8642/")
+            data = json.loads(response.read())
+            if data["status"] == "complete":
+                break
+            time.sleep(0.1)
+    finally:
+        for proc in [server, worker]:
+            if proc.poll() is None:
+                proc.terminate()
+                try:
+                    proc.wait(timeout=5)
+                except subprocess.TimeoutExpired:
+                    proc.kill()
+                    proc.wait()

queueio-0.5.0/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__acp__Bash",
-      "mcp__acp__Edit",
-      "mcp__acp__Write"
-    ]
-  }
-}