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: 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_huey-1.8.0.tar.gz.
File metadata
- Download URL: z4j_huey-1.8.0.tar.gz
- Upload date:
- Size: 25.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bf54dbc4a013148ed2b8019be39ea2c6a0c7253243c9abedd1e79077bfd73515
|
|
| MD5 |
68a4235a2b0efbde77363f0bc45aede1
|
|
| BLAKE2b-256 |
fb297599940aef5523208dde0f3100cb77cd3a82a58af54d115226214e30997a
|
File details
Details for the file z4j_huey-1.8.0-py3-none-any.whl.
File metadata
- Download URL: z4j_huey-1.8.0-py3-none-any.whl
- Upload date:
- Size: 19.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8c8312ae66c432ca2482800feb30b03484ba1017998712cf78c459178785ba57
|
|
| MD5 |
06686d9cb77089783499d62affff39a3
|
|
| BLAKE2b-256 |
0ce9e3ff8e4ce7e32076cd6a3dcf0a13381d411b65b7a5e942ee0f5e88499caa
|
