z4j-arq
The arq engine adapter for z4j.
Streams supported arq job lifecycle events from your async workers to the z4j and accepts operator control actions from the dashboard. Pair with z4j-arqcron to surface arq cron jobs.
Compatibility
- arq 0.26+ and <1 (capped below the eventual arq 1.0 breaking-major)
- Python 3.11+
Full per-adapter matrix at https://z4j.dev/reference/compatibility/.
What it ships
| Capability | Notes |
|---|---|
| Job lifecycle events | in-progress, complete, failed |
| Job discovery | caller-supplied function-name list (arq has no auto-registry) |
| Submit / cancel | direct against the arq Redis pool; cancel succeeds only when Job.abort confirms it |
| Reconcile task | via arq's Redis-backed result store |
Async-native, uses arq's existing on_job_start / on_job_end hooks.
Not yet supported (the brain greys these actions out): retry-by-id, bulk retry, and purge queue. arq exposes no job-enumeration, dead-letter, or re-enqueue-by-id primitive, so these are deferred rather than shipped.
Install
pip install z4j-arq z4j-arqcron
Pair with a framework adapter (FastAPI is the most common pairing for arq):
pip install z4j-fastapi z4j-arq z4j-arqcron
pip install z4j-bare z4j-arq z4j-arqcron # framework-free worker
Pairs with
z4j-arqcron, schedule adapter for arq cron jobs
Reliability
- Lifecycle-capture failures are isolated from arq's worker loop and job code; capture hooks make no brain network request inline.
- The in-process event queue and SQLite outbound buffer are bounded. Queue overflow drops new events and buffer pressure evicts oldest rows; both losses are logged.
Documentation
Full docs at z4j.dev/engines/arq/.
License
Apache-2.0, see LICENSE.
Links
- Homepage: https://z4j.com
- Documentation: https://z4j.dev
- PyPI: https://pypi.org/project/z4j-arq/
- Issues: https://github.com/z4jdev/z4j-arq/issues
- Changelog: CHANGELOG.md
- Security: security@z4j.com (see SECURITY.md)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file z4j_arq-1.9.1.tar.gz.
File metadata
- Download URL: z4j_arq-1.9.1.tar.gz
- Upload date:
- Size: 21.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
594fd55b01c7009739231cd55a83ce43b2e3b0d8baac89eb7855d9688fa8f25a
|
|
| MD5 |
421ffdec7b4f12425d2021ceeb39684b
|
|
| BLAKE2b-256 |
ff45d00b025b90af74179203fb652b37a3ea4005e89d8d51b77eac5636b65292
|
File details
Details for the file z4j_arq-1.9.1-py3-none-any.whl.
File metadata
- Download URL: z4j_arq-1.9.1-py3-none-any.whl
- Upload date:
- Size: 16.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c0d0ac16e1ddeb04090ade44d8708be91051342eafbce4fb334c59755465582
|
|
| MD5 |
1ea2cf5e46ca172a27429accd45c5ef9
|
|
| BLAKE2b-256 |
4f637fb9dbf440aff915e8601749e92107e892011957ddf6c3da318646f19835
|
