#tokio #async #cron #scheduler #job

jact

Schedule tasks on tokio using cron-like annotation. Also schedule tasks at an instant or repeat them at a fixed duration.

7 unstable releases

0.4.2 Oct 14, 2023
0.4.1 Dec 27, 2021
0.3.0 Dec 21, 2021
0.2.0 Dec 18, 2021
0.1.1 Dec 15, 2021

#238 in Date and time

MIT/Apache

24KB
415 lines

JACT (Just Async Chron Tokio)

Use cron-like scheduling in an async tokio environment. Also schedule tasks at an instant or repeat them at a fixed duration.

Inspired by https://github.com/mvniekerk/tokio-chron-scheduler

Usage

Creating a schedule for a job is done using the FromStr impl for the Schedule type of the cron library.

The scheduling format is as follows:

sec   min   hour   day of month   month   day of week   year
*     *     *      *              *       *             *

Time is specified for UTC and not your local timezone. Note that the year may be omitted.

Comma separated values such as 5,8,10 represent more than one time value. So for example, a schedule of 0 2,14,26 * * * * would execute on the 2nd, 14th, and 26th minute of every hour.

Ranges can be specified with a dash. A schedule of 0 0 * 5-10 * * would execute once per hour but only on day 5 through 10 of the month.

Day of the week can be specified as an abbreviation or the full name. A schedule of 0 0 6 * * Sun,Sat would execute at 6am on Sunday and Saturday.

A simple example is provided in the examples directory.


## License

jact is licensed under either of

* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
  http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
  http://opensource.org/licenses/MIT)

## Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall
be dual licensed as above, without any additional terms or conditions.

Please see the [CONTRIBUTING](CONTRIBUTING.md) file for more information.

Dependencies

~6–14MB
~139K SLoC