queueio 0.5.0__tar.gz → 0.7.0__tar.gz

queueio-0.7.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.7.0}/.gitignore

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

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

@@ -8,6 +8,35 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com).
 [Unreleased]
 ------------
 
+[0.7.0] - 2026-03-09
+--------------------
+
+### Breaking Changes
+
+- The `pika` configuration key in `[tool.queueio]` has been renamed to `broker`.
+- The `QUEUEIO_PIKA` environment variable has been renamed to `QUEUEIO_BROKER`.
+- Removed `Broker.create(queue)`, in favor of `Broker.sync([queue])`.
+- Removed `Broker.delete(queue)`, without replacement.
+- Removed `QueueIO.create(queue)`, in favor of `QueueIO.sync([queue])`.
+- Removed `QueueIO.delete(queue)`, without replacement.
+
+### Added
+
+- Added `Broker.sync()` to back `queueio sync`.
+- Added `QueueIO.sync()` to back `queueio sync`.
+- `Backend` ABC with `broker()` and `journal()` methods
+  that return independent context managers with their own lifecycles.
+
+[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 +125,9 @@ 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.7.0...HEAD
+[0.7.0]: https://github.com/ryanhiebert/queueio/compare/tag/0.6.0...tag/0.7.0
+[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.7.0/CNAME

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: queueio
-Version: 0.5.0
+Version: 0.7.0
 Summary: Python background queues with an async twist
 Author-email: Ryan Hiebert <ryan@ryanhiebert.com>
 License-Expression: MIT
@@ -18,6 +18,11 @@ 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'
+Provides-Extra: psycopg
+Requires-Dist: psycopg>=3.3; extra == 'psycopg'
 Description-Content-Type: text/markdown
 
 ![queueio](https://raw.githubusercontent.com/ryanhiebert/queueio/main/logo.svg)
@@ -68,17 +73,17 @@ Add the configuration to your `pyproject.toml`:
 
 ```toml
 [tool.queueio]
-# Configure RabbitMQ
-pika = "amqp://guest:guest@localhost:5672/"
+# Configure the broker (currently supports amqp:// URIs)
+broker = "amqp://guest:guest@localhost:5672/"
 # Register the modules that the worker should load to find your routines
 register = ["basic"]
 ```
 
-The pika configuration can be overridden with an environment variable
+The broker configuration can be overridden with an environment variable
 to allow a project to be deployed in multiple environments.
 
 ```sh
-QUEUEIO_PIKA='amqp://guest:guest@localhost:5672/'
+QUEUEIO_BROKER='amqp://guest:guest@localhost:5672/'
 ```
 
 Sync the queues to the broker:

{queueio-0.5.0 → queueio-0.7.0}/README.md

@@ -46,17 +46,17 @@ Add the configuration to your `pyproject.toml`:
 
 ```toml
 [tool.queueio]
-# Configure RabbitMQ
-pika = "amqp://guest:guest@localhost:5672/"
+# Configure the broker (currently supports amqp:// URIs)
+broker = "amqp://guest:guest@localhost:5672/"
 # Register the modules that the worker should load to find your routines
 register = ["basic"]
 ```
 
-The pika configuration can be overridden with an environment variable
+The broker configuration can be overridden with an environment variable
 to allow a project to be deployed in multiple environments.
 
 ```sh
-QUEUEIO_PIKA='amqp://guest:guest@localhost:5672/'
+QUEUEIO_BROKER='amqp://guest:guest@localhost:5672/'
 ```
 
 Sync the queues to the broker:

queueio-0.7.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.7.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.7.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.7.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.7.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/README.md
+  - Changelog: CHANGELOG.md

queueio-0.5.0/principles.md → queueio-0.7.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.7.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "queueio"
-version = "0.5.0"
+version = "0.7.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,18 +27,32 @@ dependencies = [
     "typer>=0.15.4",
 ]
 
+[project.optional-dependencies]
+django = ["django>=6.0", "django-cmd>=3.0"]
+psycopg = ["psycopg>=3.3"]
+
+[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]",
+    "queueio[psycopg]",
+    "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",
     "ruff>=0.9.6",
     "textual-dev>=1.7.0",
     "types-pika>=1.2.0b1",
+    "psycopg>=3.3.3",
 ]
 
 [tool.ruff.lint]
@@ -54,10 +68,11 @@ register = [
     "queueio.samples.priority",
     "queueio.samples.queuevar",
 ]
-pika = "amqp://localhost:5672"
+broker = "amqp://localhost:5672"
 
 [tool.pytest.ini_options]
 timeout = 30
+norecursedirs = ["site"]
 
 [tool.coverage.run]
 branch = true

queueio-0.7.0/pyrightconfig.json

@@ -0,0 +1,5 @@
+{
+  "pythonVersion": "3.14",
+  "typeCheckingMode": "standard",
+  "exclude": ["site", ".venv"]
+}

{queueio-0.5.0 → queueio-0.7.0}/queueio/__init__.py

@@ -2,7 +2,7 @@ from contextlib import contextmanager
 
 from .gather import gather as gather
 from .pause import pause as pause
-from .queueio import QueueIO as RealQueueIO
+from .queueio import QueueIO as QueueIO
 from .queueio import priority as priority
 from .queuevar import QueueVar as QueueVar
 from .registry import routine as routine
@@ -10,5 +10,5 @@ from .registry import routine as routine
 
 @contextmanager
 def activate():
-    with RealQueueIO().activate():
+    with QueueIO.default() as queueio, queueio.activate():
         yield

{queueio-0.5.0 → queueio-0.7.0}/queueio/__main__.py

@@ -1,4 +1,3 @@
-from contextlib import suppress
 from typing import Annotated
 
 import typer
@@ -32,8 +31,7 @@ app.add_typer(
 @routine_app.command("list")
 def routine_list():
     """Show all registered routines."""
-    queueio = QueueIO()
-    try:
+    with QueueIO.default() as queueio:
         routines = queueio.routines()
 
         if not routines:
@@ -53,8 +51,6 @@ def routine_list():
         print(f"{'-' * name_width}-+-{'-' * path_width}")
         for routine, path in zip(routines, function_paths, strict=False):
             print(f"{routine.name:<{name_width}} | {path:<{path_width}}")
-    finally:
-        queueio.shutdown()
 
 
 @app.command(rich_help_panel="Commands")
@@ -64,17 +60,16 @@ def monitor(raw: bool = False):
     Show a live view of queueio activity. Use --raw for detailed event output.
     """
     if raw:
-        queueio = QueueIO()
-        events = queueio.subscribe({object})
-        try:
-            while True:
-                print(events.get())
-        except KeyboardInterrupt:
-            print("Shutting down gracefully.")
-        finally:
-            queueio.shutdown()
+        with QueueIO.default() as queueio:
+            events = queueio.subscribe({object})
+            try:
+                while True:
+                    print(events.get())
+            except KeyboardInterrupt:
+                print("Shutting down gracefully.")
     else:
-        Monitor().run()
+        with QueueIO.default() as queueio:
+            Monitor(queueio).run()
 
 
 @app.command(rich_help_panel="Commands")
@@ -94,8 +89,8 @@ def run(
     The worker will process invocations from the specified queue,
     as many at a time as specified by the concurrency.
     """
-    queueio = QueueIO()
-    Worker(queueio, queuespec)()
+    with QueueIO.default() as queueio:
+        Worker(queueio, queuespec)()
 
 
 @app.command(rich_help_panel="Commands")
@@ -103,14 +98,13 @@ def sync(
     recreate: Annotated[
         bool,
         typer.Option(
-            help="Delete and recreate queues that have incompatible arguments. "
-            "WARNING: This will lose any pending messages in those queues.",
+            help="Recreate all resources for the broker and journal. "
+            "WARNING: This will lose pending messages.",
         ),
     ] = False,
 ):
-    """Sync known queues to the broker."""
-    queueio = QueueIO()
-    try:
+    """Sync resources for the broker and journal."""
+    with QueueIO.default() as queueio:
         routines = queueio.routines()
 
         if not routines:
@@ -119,33 +113,21 @@ def sync(
 
         queues = sorted({routine.queue for routine in routines})
 
-        print(f"Syncing queues for {len(routines)} routine(s):")
-        if recreate:
-            for queue in queues:
-                print(f"  Recreating queue: {queue}")
-                with suppress(Exception):
-                    queueio.delete(queue=queue)
-
-        failed = []
+        print(f"Discovered queues for {len(routines)} routine(s):")
         for queue in queues:
-            print(f"  Ensuring queue exists: {queue}")
-            try:
-                queueio.create(queue=queue)
-            except Exception:
-                failed.append(queue)
+            print(f"  {queue}")
 
-        if failed:
+        try:
+            queueio.sync(queues, recreate=recreate)
+        except Exception:
             print(
-                f"\nError: {len(failed)} queue(s) have incompatible arguments: "
-                f"{', '.join(failed)}\n"
-                f"Re-run with --recreate to delete and recreate them.\n"
-                f"WARNING: This will lose any pending messages in those queues."
+                "\nError: Failed to sync resources.\n"
+                "Re-run with --recreate to recreate them.\n"
+                "WARNING: This will lose pending messages."
             )
-            raise typer.Exit(1)
+            raise typer.Exit(1) from None
 
         print(f"Successfully synced {len(queues)} queue(s)")
-    finally:
-        queueio.shutdown()
 
 
 @queue_app.command("purge")
@@ -164,8 +146,7 @@ def queue_purge(
     This will remove all pending messages from the given queues.
     Use with caution as this operation cannot be undone.
     """
-    queueio = QueueIO()
-    try:
+    with QueueIO.default() as queueio:
         queue_list = [q.strip() for q in queues.split(",") if q.strip()]
         if not queue_list:
             print("Error: No valid queue names provided")
@@ -176,8 +157,6 @@ def queue_purge(
             queueio.purge(queue=queue)
 
         print(f"Successfully purged {len(queue_list)} queue(s)")
-    finally:
-        queueio.shutdown()
 
 
 if __name__ == "__main__":

queueio-0.7.0/queueio/backend.py

@@ -0,0 +1,18 @@
+from abc import ABC
+from abc import abstractmethod
+from contextlib import AbstractContextManager
+
+from .broker import Broker
+from .journal import Journal
+
+
+class Backend(ABC):
+    """A backend provides context-managed access to a broker and journal."""
+
+    @abstractmethod
+    def broker(self) -> AbstractContextManager[Broker]:
+        raise NotImplementedError("Subclasses must implement this method.")
+
+    @abstractmethod
+    def journal(self) -> AbstractContextManager[Journal]:
+        raise NotImplementedError("Subclasses must implement this method.")

{queueio-0.5.0 → queueio-0.7.0}/queueio/broker.py

@@ -1,5 +1,6 @@
 from abc import ABC
 from abc import abstractmethod
+from collections.abc import Iterable
 
 from .queuespec import QueueSpec
 from .receiver import Receiver
@@ -13,10 +14,13 @@ class Broker(ABC):
     at-least-once delivery.
     """
 
-    @classmethod
     @abstractmethod
-    def from_uri(cls, uri: str, /):
-        """Create a broker instance from a URI."""
+    def sync(self, queues: Iterable[str], *, recreate: bool = False):
+        """Ensure the given queues are ready to use.
+
+        If recreate is True, destroy and recreate all resources,
+        losing any pending messages.
+        """
         raise NotImplementedError("Subclasses must implement this method.")
 
     @abstractmethod
@@ -24,16 +28,6 @@ class Broker(ABC):
         """Enqueue a message."""
         raise NotImplementedError("Subclasses must implement this method.")
 
-    @abstractmethod
-    def create(self, *, queue: str):
-        """Create a queue if it doesn't exist."""
-        raise NotImplementedError("Subclasses must implement this method.")
-
-    @abstractmethod
-    def delete(self, *, queue: str):
-        """Delete a queue."""
-        raise NotImplementedError("Subclasses must implement this method.")
-
     @abstractmethod
     def purge(self, *, queue: str):
         """Purge all messages from the queue."""

{queueio-0.5.0 → queueio-0.7.0}/queueio/broker_test.py

@@ -60,7 +60,7 @@ class BaseBrokerTest:
     @pytest.mark.timeout(2)
     def test_prefetch_limits_message_consumption(self, broker):
         """Verify that prefetch parameter limits message consumption."""
-        broker.create(queue="test-queue")
+        broker.sync(["test-queue"])
         broker.purge(queue="test-queue")
 
         # Enqueue more messages than prefetch limit
@@ -93,7 +93,7 @@ class BaseBrokerTest:
     @pytest.mark.timeout(2)
     def test_suspend_resume_affects_prefetch_capacity(self, broker):
         """Verify suspending messages frees capacity and resuming reduces it."""
-        broker.create(queue="test-queue")
+        broker.sync(["test-queue"])
         broker.purge(queue="test-queue")
 
         # Enqueue messages
@@ -131,7 +131,7 @@ class BaseBrokerTest:
     @pytest.mark.timeout(2)
     def test_complete_message_frees_prefetch_capacity(self, broker):
         """Verify completing messages frees up capacity."""
-        broker.create(queue="test-queue")
+        broker.sync(["test-queue"])
         broker.purge(queue="test-queue")
 
         # Enqueue more messages than prefetch limit
@@ -171,7 +171,7 @@ class BaseBrokerTest:
     @pytest.mark.timeout(2)
     def test_multiple_receivers_independent_prefetch_limits(self, broker):
         """Verify multiple receivers operate with independent prefetch limits."""
-        broker.create(queue="test-queue")
+        broker.sync(["test-queue"])
         broker.purge(queue="test-queue")
 
         # Enqueue enough messages for both receivers
@@ -223,8 +223,7 @@ class BaseBrokerTest:
     @skip_if_unsupported("supports_multiple_queues")
     def test_receive_supports_multiple_queues(self, broker):
         """Verify broker can receive from multiple queues."""
-        broker.create(queue="queue1")
-        broker.create(queue="queue2")
+        broker.sync(["queue1", "queue2"])
         broker.purge(queue="queue1")
         broker.purge(queue="queue2")
 
@@ -260,10 +259,7 @@ class BaseBrokerTest:
     def test_multiple_queues_with_mixed_empty_and_filled(self, broker):
         """Verify broker handles multiple queues with some empty, some with messages."""
 
-        broker.create(queue="empty1")
-        broker.create(queue="filled")
-        broker.create(queue="empty2")
-        broker.create(queue="also_filled")
+        broker.sync(["empty1", "filled", "empty2", "also_filled"])
         broker.purge(queue="empty1")
         broker.purge(queue="filled")
         broker.purge(queue="empty2")
@@ -308,8 +304,7 @@ class BaseBrokerTest:
         probability in the round-robin selection.
         """
 
-        broker.create(queue="priority_queue")
-        broker.create(queue="normal_queue")
+        broker.sync(["priority_queue", "normal_queue"])
         broker.purge(queue="priority_queue")
         broker.purge(queue="normal_queue")
 
@@ -410,9 +405,7 @@ class BaseBrokerTest:
         the message, not just cycle by a fixed amount.
         """
 
-        broker.create(queue="empty")
-        broker.create(queue="queue1")
-        broker.create(queue="queue2")
+        broker.sync(["empty", "queue1", "queue2"])
         broker.purge(queue="empty")
         broker.purge(queue="queue1")
         broker.purge(queue="queue2")
@@ -473,7 +466,7 @@ class BaseBrokerTest:
     @pytest.mark.timeout(2)
     def test_higher_priority_consumed_first(self, broker):
         """Verify that higher priority messages are consumed before lower ones."""
-        broker.create(queue="test-queue")
+        broker.sync(["test-queue"])
         broker.purge(queue="test-queue")
 
         # Enqueue low priority first, then high priority