z4j-huey 1.7.0

z4j Huey queue engine adapter (Apache 2.0)

z4j-huey

The Huey engine adapter for z4j.

Streams every Huey task lifecycle event from your consumers to the z4j brain and accepts operator control actions from the dashboard. Pair with z4j-hueyperiodic to surface @periodic_task schedules.

What it ships

Capability	Notes
Task lifecycle events	enqueued, started, succeeded, failed, retried, revoked
Task discovery	Huey's in-process task registry
Submit / retry / cancel	direct against the Huey instance
Reconcile task	probes Huey's result store; absence reports honest unknown

Not supported (Huey's storage model can't back them faithfully, so the adapter declines the capability instead of faking it): bulk retry, queue purge, dead-letter requeue, worker restart, rate limiting.

Compatibility

• Huey 2.4+ and <3 (capped below the Huey 3.0 breaking-major)
• Storage backends: redis, sqlite, in-memory
• Python 3.11+

Full per-adapter matrix at https://z4j.dev/reference/compatibility/.

Install

pip install z4j-huey z4j-hueyperiodic

Pair with a framework adapter:

pip install z4j-django  z4j-huey z4j-hueyperiodic   # Django
pip install z4j-flask   z4j-huey z4j-hueyperiodic   # Flask
pip install z4j-fastapi z4j-huey z4j-hueyperiodic   # FastAPI
pip install z4j-bare    z4j-huey z4j-hueyperiodic   # framework-free worker

Pairs with

• z4j-hueyperiodic, schedule adapter for Huey @periodic_task

Reliability

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

Documentation

Full docs at z4j.dev/engines/huey/.

License

Apache-2.0, see LICENSE.

Links

• Homepage: https://z4j.com
• Documentation: https://z4j.dev
• PyPI: https://pypi.org/project/z4j-huey/
• Issues: https://github.com/z4jdev/z4j-huey/issues
• Changelog: CHANGELOG.md
• Security: [e-mail] (see SECURITY.md)