z4j-arqcron 1.6.7

z4j scheduler adapter for arq cron jobs (Apache 2.0)

z4j-arqcron

The arq cron-jobs scheduler adapter for z4j.

Surfaces every cron job your arq Settings class registers on the dashboard's Schedules page, read, enable, disable, trigger.

Compatibility

• arq 0.26+ and <1
• Python 3.10+

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

What it ships

Capability	Notes
List schedules	every cron_jobs entry on your arq Settings
Read	by registered name
Enable / disable	via consumer-side gating
Trigger now	enqueues the task immediately, outside the schedule
Boot inventory	full snapshot at agent connect; existing cron jobs show up without editing

arq cron jobs are defined declaratively on the WorkerSettings class, so create / update / delete are intentionally out of scope, those need a deploy round-trip. The dashboard hides buttons it can't honor.

Install

pip install z4j-arq z4j-arqcron

from arq import cron
from z4j_bare import install_agent
from z4j_arq import ArqEngineAdapter
from z4j_arqcron import ArqCronAdapter

class WorkerSettings:
    redis_settings = ...
    cron_jobs = [
        cron(cleanup, minute=set(range(0, 60, 5))),
    ]

install_agent(
    engines=[ArqEngineAdapter(settings=WorkerSettings)],
    schedulers=[ArqCronAdapter(settings=WorkerSettings)],
    brain_url="https://brain.example.com",
    token="z4j_agent_...",
    project_id="my-project",
)

Pairs with

• z4j-arq, engine adapter

Reliability

• No exception from the adapter ever propagates back into arq's worker loop or your job code.
• The cron-jobs registry is read-only at runtime; the adapter only observes, it does not rewrite WorkerSettings.

Documentation

Full docs at z4j.dev/schedulers/arq-cron/.

License

Apache-2.0, see LICENSE.

Links

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