localqueue 0.3.3__tar.gz → 0.3.4__tar.gz

{localqueue-0.3.3 → localqueue-0.3.4}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.3.4
+
+- Keep `queue exec` and `queue process` alive in `--forever --block` mode when the queue starts empty.
+- Preserve the batch empty-queue exit behavior for non-forever workers.
+
 ## 0.3.3
 
 - Split queue and retry store implementations into dedicated modules.

{localqueue-0.3.3 → localqueue-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: localqueue
-Version: 0.3.3
+Version: 0.3.4
 Summary: Durable local queues for Python, with persistent retry state powered by Tenacity.
 Project-URL: Homepage, https://brunoportis.github.io/localqueue/
 Project-URL: Documentation, https://brunoportis.github.io/localqueue/

{localqueue-0.3.3 → localqueue-0.3.4}/docs/release.md

@@ -108,4 +108,4 @@ Before `1.0.0`, use this convention:
 
 ## Current Release
 
-The current planned release is `0.3.3`.
+The current planned release is `0.3.4`.

{localqueue-0.3.3 → localqueue-0.3.4}/localqueue/services/queue_worker.py

@@ -352,6 +352,8 @@ def process_queue_messages(
                 )
             )
             if empty_queue:
+                if options.forever and options.block:
+                    continue
                 return handle_empty_queue(err_console, processed)
             assert iteration is not None
             if handle_processed_queue_result(

{localqueue-0.3.3 → localqueue-0.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "localqueue"
-version = "0.3.3"
+version = "0.3.4"
 description = "Durable local queues for Python, with persistent retry state powered by Tenacity."
 readme = "README.md"
 requires-python = ">=3.11"

{localqueue-0.3.3 → localqueue-0.3.4}/tests/test_cli.py

@@ -58,6 +58,7 @@ from localqueue.cli_worker_commands import (
 )
 from localqueue.services.queue_worker import (
     QueueIterationContext as _QueueIterationContext,
+    QueueIterationResult as _QueueIterationResult,
     QueueWorkerOptions as _QueueWorkerOptions,
     _CommandExecutionError,
     _CommandNotFoundError,
@@ -1747,6 +1748,55 @@ class CliTests(unittest.TestCase):
         self.assertEqual(console.values, [])
         self.assertEqual(err_console.messages, ["[yellow]queue is empty[/yellow]"])
 
+    def test_process_queue_messages_keeps_waiting_when_forever_blocking_is_empty(
+        self,
+    ) -> None:
+        queue = PersistentQueue("emails", store=MemoryQueueStore())
+        console = _JsonConsole()
+        err_console = _JsonConsole()
+        shutdown = _ShutdownState()
+
+        def stop_after_second_poll(
+            context: _QueueIterationContext,
+        ) -> tuple[_QueueIterationResult | None, SQLiteAttemptStore | None, bool]:
+            if shutdown.requested:
+                return None, None, True
+            shutdown.requested = True
+            self.assertTrue(context.forever)
+            self.assertTrue(context.block)
+            return None, None, True
+
+        with mock.patch(
+            "localqueue.services.queue_worker.process_queue_iteration",
+            side_effect=stop_after_second_poll,
+        ) as process_iteration:
+            result = _process_queue_messages(
+                queue,
+                lambda payload: payload,
+                console=console,
+                err_console=err_console,
+                shutdown=shutdown,
+                options=_QueueWorkerOptions(
+                    retry_store_path=self._retry_store_path(),
+                    max_jobs=1,
+                    forever=True,
+                    max_tries=1,
+                    worker_id="worker-a",
+                    block=True,
+                    timeout=None,
+                    idle_sleep=0.001,
+                    release_delay=0.0,
+                    dead_letter_on_exhaustion=True,
+                    log_events=False,
+                    mode="process",
+                ),
+            )
+
+        self.assertEqual(result, 0)
+        self.assertEqual(console.values, [{"state": "stopped", "processed": 0}])
+        self.assertEqual(err_console.messages, [])
+        self.assertEqual(process_iteration.call_count, 1)
+
     def test_process_queue_iteration_handles_forever_empty_queue_without_blocking(
         self,
     ) -> None:

{localqueue-0.3.3 → localqueue-0.3.4}/uv.lock

@@ -200,7 +200,7 @@ wheels = [
 
 [[package]]
 name = "localqueue"
-version = "0.3.3"
+version = "0.3.4"
 source = { editable = "." }
 dependencies = [
     { name = "tenacity" },