z4j-rq 1.7.0

z4j RQ queue engine adapter (Apache 2.0)

z4j-rq

The RQ engine adapter for z4j.

Streams every RQ job lifecycle event 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+ 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	filter-driven; re-enqueues matching jobs from the 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

• No exception from the adapter ever propagates back into your RQ workers or job hooks.
• Events buffer locally when z4j is unreachable; workers never block on network I/O.

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: [e-mail] (see SECURITY.md)