huey-periodic
Requires Huey 2.4+, on Huey 2 or Huey 3, Python 3.11+. See the compatibility matrix for the full pin string.
Install
Section titled “Install”pip install z4j-hueyperiodicWhy read-only
Section titled “Why read-only”Huey's periodic tasks are defined via @huey.periodic_task(crontab(...)) decorators. You can't "add a new periodic task at runtime" without adding code. The dashboard shows them; it cannot create new ones.
What you can do
Section titled “What you can do”| Op | Supported |
|---|---|
| List all periodic tasks with their crontab | ✓ |
| Show the equivalent five-field crontab | ✓ |
| Pause / resume an existing periodic task | ✗ |
| Create / delete | ✗ (requires code change) |
Caveats
Section titled “Caveats”- Inventory mapping is authoritative. If a periodic definition cannot be mapped, the adapter aborts that snapshot instead of falsely deleting the schedule from the brain mirror.
Migrating to z4j-scheduler
Section titled “Migrating to z4j-scheduler”If you move scheduling to z4j-scheduler,
z4j-scheduler import --from huey --huey-app pkg.module:huey --project <slug>
reads the periodic_task registry from the same import path your consumer
uses, and z4j-scheduler export --to huey renders the registrations back as a
Python module you review and apply.
Paired with
Section titled “Paired with”Huey.