Metadata-Version: 2.4
Name: z4j-rqscheduler
Version: 1.0.1
Summary: z4j scheduler adapter for rq-scheduler (Apache 2.0)
Project-URL: Changelog, https://github.com/z4jdev/z4j-rqscheduler/blob/main/CHANGELOG.md
Project-URL: Documentation, https://z4j.dev
Project-URL: Homepage, https://z4j.com
Project-URL: Issues, https://github.com/z4jdev/z4j-rqscheduler/issues
Project-URL: Source, https://github.com/z4jdev/z4j-rqscheduler
Author: z4j contributors
License: Apache-2.0
License-File: LICENSE
Keywords: cron,rq,rq-scheduler,scheduler,z4j
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Distributed Computing
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: rq-scheduler>=0.13
Requires-Dist: z4j-core
Requires-Dist: z4j-rq
Description-Content-Type: text/markdown

# z4j-rqscheduler

[![PyPI version](https://img.shields.io/pypi/v/z4j-rqscheduler.svg)](https://pypi.org/project/z4j-rqscheduler/)
[![Python](https://img.shields.io/pypi/pyversions/z4j-rqscheduler.svg)](https://pypi.org/project/z4j-rqscheduler/)
[![License](https://img.shields.io/pypi/l/z4j-rqscheduler.svg)](https://github.com/z4jdev/z4j-rqscheduler/blob/main/LICENSE)


**License:** Apache 2.0
**Status:** v2026.5 - first public release alongside `z4j-rq`.

z4j scheduler-axis adapter for
[rq-scheduler](https://github.com/rq/rq-scheduler). Pairs with
`z4j-rq` the same way `z4j-celerybeat` pairs with `z4j-celery` -
adds scheduled-job management to the dashboard Schedules page for
projects that run RQ.

## Install

```bash
pip install z4j[rq,rqscheduler]
# or standalone:
pip install z4j-rqscheduler
```

## Capabilities

Advertised via the standard `SchedulerAdapter.capabilities()`
contract:

| Token | Status | Note |
|---|---|---|
| `list` | ✅ | Reads every scheduled job from the rq-scheduler Redis zset |
| `enable` / `disable` | ✅ | via `Scheduler.enqueue_in(0, ...)` pause/resume pattern |
| `trigger_now` | ✅ | `Scheduler.enqueue_in(timedelta(0), func, *args)` |
| `delete` | ✅ | `Scheduler.cancel(job)` |
| `create` / `update` | ⏸️ | Deferred to v1.1 - the UI surface for creating schedules lives on the Celery track first |

## See also

- [`packages/z4j-rq/`](../z4j-rq/) - the engine adapter this pairs with.
- [`docs/ADAPTER.md`](../../docs/ADAPTER.md) - generic adapter guide.

## License

Apache 2.0 - see [LICENSE](LICENSE). This package is deliberately permissively licensed so that proprietary Django / Flask / FastAPI applications can import it without any license concerns.

## Links

- Homepage: <https://z4j.com>
- Documentation: <https://z4j.dev>
- Source: <https://github.com/z4jdev/z4j-rqscheduler>
- Issues: <https://github.com/z4jdev/z4j-rqscheduler/issues>
- Changelog: [CHANGELOG.md](CHANGELOG.md)
- Security: `security@z4j.com` (see [SECURITY.md](SECURITY.md))
