z4j-huey
The Huey engine adapter for z4j.
Streams supported Huey task lifecycle events 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 | direct against the Huey instance |
| Retry | requires both complete operator-supplied replacement args and kwargs because Huey cannot recover the original signature by task id |
| Cancel | prevents a pending task from starting; Huey cannot interrupt already-running work |
| 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. Cancel uses Huey's revoke-by-id primitive. It prevents a pending task from starting but cannot stop running work.
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
- Lifecycle-capture failures are isolated from Huey hooks and task 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/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
Metadata
1 maintainer
Release files for z4j-huey 1.11.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| z4j_huey-1.11.0.tar.gz | 27.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| z4j_huey-1.11.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 47.9 kB
Release files / z4j_huey-1.11.0.tar.gz
| Download URL | z4j_huey-1.11.0.tar.gz |
|---|---|
| Size | 27.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
925140538bfa7c9f0c6178e55858bd797936c5d025ad0f4f7adccc720faa7cf7
|
|
BLAKE2b-256 checksum How to use checksums |
83632afd023f19e6d3bd544081b30cb94bcd7b7b424e62fb945b68af37858c29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / z4j_huey-1.11.0-py3-none-any.whl
| Download URL | z4j_huey-1.11.0-py3-none-any.whl |
|---|---|
| Size | 20.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
046cee4d8fd041e48e269b11cfa54c2d84ab7391da02e723868b729e11a54690
|
|
BLAKE2b-256 checksum How to use checksums |
bef9dc8058167ed3ffe67b0cb61a726afb34169f284be61759e40b229053ef4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
