localqueue 0.1.0__tar.gz → 0.1.1__tar.gz

{localqueue-0.1.0 → localqueue-0.1.1}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.1.1
+
+- Add project URLs for PyPI metadata.
+- Document `queue exec` command-failure fields stored in `last_error`.
+
 ## 0.1.0
 
 - Add persistent retry wrappers for sync and async Tenacity retryers.

{localqueue-0.1.0 → localqueue-0.1.1}/PKG-INFO

@@ -1,7 +1,11 @@
 Metadata-Version: 2.4
 Name: localqueue
-Version: 0.1.0
+Version: 0.1.1
 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/
+Project-URL: Repository, https://github.com/brunoportis/localqueue
+Project-URL: Issues, https://github.com/brunoportis/localqueue/issues
 Author: Bruno Portis
 License-Expression: MIT
 License-File: LICENSE
@@ -159,6 +163,10 @@ localqueue queue exec webhooks -- curl -X POST https://example.com/hook -d @-
 localqueue queue exec emails -- sh -c 'jq -r .to | xargs -I{} curl https://example.com/{}'
 ```
 
+Command output is captured so the CLI can keep printing its own JSON status.
+When a command fails, `last_error` includes the command, exit code, stdout, and
+stderr, truncated for inspection.
+
 Use `--forever` for a long-running worker. When interrupted with `SIGINT` or
 `SIGTERM`, the CLI finishes the current message before stopping.
 

{localqueue-0.1.0 → localqueue-0.1.1}/README.md

@@ -128,6 +128,10 @@ localqueue queue exec webhooks -- curl -X POST https://example.com/hook -d @-
 localqueue queue exec emails -- sh -c 'jq -r .to | xargs -I{} curl https://example.com/{}'
 ```
 
+Command output is captured so the CLI can keep printing its own JSON status.
+When a command fails, `last_error` includes the command, exit code, stdout, and
+stderr, truncated for inspection.
+
 Use `--forever` for a long-running worker. When interrupted with `SIGINT` or
 `SIGTERM`, the CLI finishes the current message before stopping.
 

{localqueue-0.1.0 → localqueue-0.1.1}/docs/api.md

@@ -94,6 +94,10 @@ Dataclass returned by `put()` and `get_message()`.
 | `last_error` | structured error from the most recent failed processing attempt, if recorded |
 | `failed_at` | timestamp for `last_error`, if recorded |
 
+For `localqueue queue exec` failures, `last_error` also includes `command`,
+`exit_code`, `stdout`, and `stderr` fields so command workers can be inspected
+from `queue inspect` and `queue dead`.
+
 #### `QueueStats`
 
 Dataclass returned by `stats()`.

{localqueue-0.1.0 → localqueue-0.1.1}/docs/index.md

@@ -50,6 +50,8 @@ localqueue queue exec emails -- python scripts/send_email.py
 `queue exec` writes the message value to the command's stdin as JSON. Exit code
 `0` acknowledges the message. Any other exit code is treated as a failed handler
 attempt and follows the configured retry, release, and dead-letter policy.
+Command failures are recorded in `last_error` with the command, exit code,
+stdout, and stderr.
 
 Run a continuous local worker with `--forever`. `SIGINT` and `SIGTERM` request a
 graceful stop after the current message finishes.

{localqueue-0.1.0 → localqueue-0.1.1}/docs/queues.md

@@ -95,9 +95,19 @@ localqueue queue exec jobs -- sh -c 'jq -r .id | xargs -I{} ./process-job {}'
 
 The command receives `message.value` on stdin as JSON. `localqueue` captures the
 command output so the CLI can keep printing its own JSON status. Exit code `0`
-acks the message. Any other exit code raises a command failure, records the exit
-code and stderr in `last_error`, and applies the same retry, release, or
-dead-letter behavior as `queue process`.
+acks the message. Any other exit code raises a command failure and applies the
+same retry, release, or dead-letter behavior as `queue process`.
+
+Command failures are stored in `last_error` with structured fields:
+
+| Field | Meaning |
+| --- | --- |
+| `type` | `_CommandExecutionError` |
+| `message` | human-readable command failure |
+| `command` | argv list that was executed |
+| `exit_code` | command exit code |
+| `stdout` | captured stdout, truncated for inspection |
+| `stderr` | captured stderr, truncated for inspection |
 
 Commands are executed without an implicit shell. Use `sh -c` explicitly when you
 want pipes, redirects, shell expansion, or multiple commands.

{localqueue-0.1.0 → localqueue-0.1.1}/docs/release.md

@@ -104,4 +104,4 @@ Before `1.0.0`, use this convention:
 
 ## Current Release
 
-The current planned release is `0.1.0`.
+The current planned release is `0.1.1`.

{localqueue-0.1.0 → localqueue-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "localqueue"
-version = "0.1.0"
+version = "0.1.1"
 description = "Durable local queues for Python, with persistent retry state powered by Tenacity."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -43,6 +43,12 @@ all = [
 [project.scripts]
 localqueue = "localqueue.cli:main"
 
+[project.urls]
+Homepage = "https://brunoportis.github.io/localqueue/"
+Documentation = "https://brunoportis.github.io/localqueue/"
+Repository = "https://github.com/brunoportis/localqueue"
+Issues = "https://github.com/brunoportis/localqueue/issues"
+
 [build-system]
 requires = ["hatchling>=1.27.0"]
 build-backend = "hatchling.build"

{localqueue-0.1.0 → localqueue-0.1.1}/uv.lock

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