z4j-hueyperiodic

The Huey @periodic_task scheduler adapter for z4j.

Surfaces every @periodic_task decorator your Huey app registers on the dashboard's Schedules page as read-only inventory.

Compatibility

• Huey 2.4+ and <4
• Python 3.11+

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

What it ships

This adapter is read-only (capabilities() returns {list, read}). Huey's periodic tasks are decorator-defined in your source (the @periodic_task argument is the schedule), so create / update / delete / enable / disable / trigger-now are all out of scope, those need a source edit and deploy round-trip. The dashboard greys out the buttons it can't honor.

Install

pip install z4j-huey z4j-hueyperiodic

from huey import RedisHuey, crontab
from z4j_bare import install_agent
from z4j_huey import HueyEngineAdapter
from z4j_hueyperiodic import HueyPeriodicAdapter

huey = RedisHuey("myapp", url="redis://localhost")

@huey.periodic_task(crontab(minute="*/5"))
def cleanup():
    ...

install_agent(
    engines=[HueyEngineAdapter(huey=huey)],
    schedulers=[HueyPeriodicAdapter(huey=huey)],
    brain_url="https://brain.example.com",
    token="z4j_agent_...",
    project_id="my-project",
)

Pairs with

• z4j-huey, engine adapter

Reliability

• No exception from the adapter ever propagates back into Huey consumers or your task code.
• The decorator's runtime behavior is unchanged, z4j observes through Huey's standard hooks.

Documentation

Full docs at z4j.dev/schedulers/huey-periodic/.

License

Apache-2.0, see LICENSE.

Links

• Homepage: https://z4j.com
• Documentation: https://z4j.dev
• PyPI: https://pypi.org/project/z4j-hueyperiodic/
• Issues: https://github.com/z4jdev/z4j-hueyperiodic/issues
• Changelog: CHANGELOG.md
• Security: security@z4j.com (see SECURITY.md)