z4j-rq
The RQ engine adapter for z4j.
Streams supported RQ job lifecycle events from your workers to z4j and accepts operator control actions from the dashboard. Pair with z4j-rqscheduler to manage periodic schedules.
Compatibility
- RQ 1.10.1+ and <3 (capped below the RQ 3.0 breaking-major rewrite)
- Python 3.11+
Full per-adapter matrix at https://z4j.dev/reference/compatibility/.
What it ships
| Capability | Notes |
|---|---|
| Job lifecycle events | started, succeeded, failed, revoked (canceled) |
| Job discovery | runtime registry of queue names + worker introspection |
| Submit / retry / cancel | direct against the RQ queue |
| Bulk retry | retries brain-resolved, project-owned explicit IDs by reference; never sweeps the broker-wide failed registry |
| Purge queue | with confirm-token guard |
| Reconcile task | via Redis-backed job hash lookup |
Install
pip install z4j-rq z4j-rqscheduler
Pair with a framework adapter:
pip install z4j-django z4j-rq z4j-rqscheduler # Django
pip install z4j-flask z4j-rq z4j-rqscheduler # Flask
pip install z4j-fastapi z4j-rq z4j-rqscheduler # FastAPI
pip install z4j-bare z4j-rq z4j-rqscheduler # framework-free worker
Pairs with
z4j-rqscheduler, schedule adapter for rq-scheduler
Reliability
- Lifecycle-capture failures are isolated from RQ workers and job hooks; 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/rq/.
License
Apache-2.0, see LICENSE.
Links
- Homepage: https://z4j.com
- Documentation: https://z4j.dev
- PyPI: https://pypi.org/project/z4j-rq/
- Issues: https://github.com/z4jdev/z4j-rq/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_rq-1.9.1.tar.gz.
File metadata
- Download URL: z4j_rq-1.9.1.tar.gz
- Upload date:
- Size: 59.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ce55d2c0d17ef1c2a8fd8daab0ef1bd4e32ff79fe72e93a9d6cf7b19aa1b7df5
|
|
| MD5 |
301484dafbc634295c550a21dffa332d
|
|
| BLAKE2b-256 |
282a140fa379cb71bf340a9a222dfe660e1b8906c7c5f59d667d89c54c3063ac
|
File details
Details for the file z4j_rq-1.9.1-py3-none-any.whl.
File metadata
- Download URL: z4j_rq-1.9.1-py3-none-any.whl
- Upload date:
- Size: 53.6 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 |
8fb9fd18cd1e5e8b95918c3416c23e342bca198413a04ccb586a1672599b1940
|
|
| MD5 |
9b6f257b9f96a639f7af3321dcbbf724
|
|
| BLAKE2b-256 |
c15a9eb609bfe09724003e5c5aabb86be3b9a14a07e417f2a82ef7282d1eb677
|
