rescript-cron

Bindings for node-cron, a tool that allows you to execute something on a schedule. This is typically done using the cron syntax:

*    *    *    *    *    *
┬    ┬    ┬    ┬    ┬    ┬
│    │    │    │    │    │
│    │    │    │    │    └ day of week (0 - 6, or sun - sat), 0 is Sunday
│    │    │    │    └───── month (0 - 11, or jan - dec)
│    │    │    └────────── day of month (1 - 31)
│    │    └─────────────── hour (0 - 23)
│    └──────────────────── minute (0 - 59)
└───────────────────────── second (0 - 59, OPTIONAL)

Learn more about the syntax at crontab.guru (NB it does not have the seconds parameter and months start at 1 (this lib has 0-indexed months)).

Getting started

npm install rescript-cron

Then add rescript-cron as a dependency in rescript.json:

{
+  "dependencies": ["rescript-cron"]
}

Example

open RescriptCron

// Make a job that will fire every second when started
let job =
  CronJob.make(
    #CronString("* * * * * *"),
    _ => Console.log("Just doing my job"),
    (),
  )

// Firing every second, printing 'Just doing my job'
start(job)

let time =
  CronTime.make(#JsDate(Date.fromString("2021-04-11T10:20:30Z")), ())

// setTime will stop the current job, and change when it will fire next
setTime(job, time)

// It will now fire once in april 2021
start(job)

The tests have more examples of how to use these bindings.

Contribute

• If you find bugs or want to improve this library, feel free to open an issue or PR.
• Commits must follow conventional commits.

Alternatives

node-schedule is a JS library similar to node-cron (which this library is bindings for).