2 stable releases
Uses old Rust 2015
1.2.2 | Jan 26, 2024 |
---|
#251 in Date and time
13KB
109 lines
NO LONGER MAINTAINED
The project I created this crate for is no longer in use, so I haven't really had the time to keep on top of keeping things up to date. I recommend looking at other options if you need the functionality this project provides.
If someone would like to take over the project, please let me know.
JobScheduler
A simple cron-like job scheduling library for Rust.
Usage
Please see the Documentation for more details.
Be sure to add the job_scheduler crate to your Cargo.toml
:
[dependencies]
job_scheduler = "*"
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 usage example:
extern crate job_scheduler;
use job_scheduler::{JobScheduler, Job};
use std::time::Duration;
fn main() {
let mut sched = JobScheduler::new();
sched.add(Job::new("1/10 * * * * *".parse().unwrap(), || {
println!("I get executed every 10 seconds!");
}));
loop {
sched.tick();
std::thread::sleep(Duration::from_millis(500));
}
}
Similar Libraries
- cron the cron expression parser we use.
- schedule-rs is a similar rust library that implements it's own cron expression parser.
License
JobScheduler is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (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 file for more information.
Dependencies
~2.2–7.5MB
~55K SLoC