z4j-rqscheduler

The rq-scheduler adapter for z4j.

Surfaces rq-scheduler periodic / interval / cron jobs on the dashboard's Schedules page, read, trigger, disable (cancel), delete.

Compatibility

• rq-scheduler 0.11+ (no upper cap)
• Python 3.11+

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

What it ships

Schedule create and update are not yet supported from the dashboard for rq-scheduler, so the brain greys those actions out. Define schedules in your project's Python entrypoint (scheduler.cron(...) / scheduler.schedule(...)); z4j inventories them and exposes the supported trigger, disable, and delete controls once they exist. Enable is not advertised because a cancelled definition cannot be restored by rq-scheduler; re-register it from application code instead.

Install

pip install z4j-rq z4j-rqscheduler

import os

from rq import Queue
from rq_scheduler import Scheduler
from redis import Redis
from z4j_bare import install_agent
from z4j_rq import RqEngineAdapter
from z4j_rqscheduler import RqSchedulerAdapter

redis = Redis(host="localhost")
queue = Queue(connection=redis)
scheduler = Scheduler(queue=queue, connection=redis)

install_agent(
    engines=[RqEngineAdapter(rq_app=queue)],
    schedulers=[RqSchedulerAdapter(scheduler=scheduler)],
    brain_url="https://brain.example.com",
    token="z4j_agent_...",
    project_id="my-project",
    hmac_secret=os.environ["Z4J_HMAC_SECRET"],
)

Pairs with

• z4j-rq, engine adapter

Reliability

• rq-scheduler has no registry-change signal, so z4j refreshes inventory at boot and during periodic reconciliation.
• Redis calls run on the adapter's bounded offload pool. A mutation that exceeds its 10-second timeout is reported as indeterminate because the worker thread may still complete it.

Documentation

Full docs at docs.z4j.com/schedulers/rq-scheduler/.

License

Apache-2.0, see LICENSE.

Links

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