skedge
Rust single-process scheduling. Ported from schedule for Python, in turn inspired by clockwork (Ruby), and "Rethinking Cron" by Adam Wiggins.
Usage
Documentation can be found on docs.rs.
This library uses the Builder pattern to define jobs. Instantiate a fresh Scheduler, then use the every() and every_single() functions to begin defining a job. Finalize configuration by calling Job::run() to add the new job to the scheduler. The Scheduler::run_pending() method is used to fire any jobs that have arrived at their next scheduled run time. Currently, precision can only be specified to the second, no smaller.
use chrono::Local; use skedge::{every, Scheduler}; use std::thread::sleep; use std::time::Duration; fn greet(name: &str) { println!("Hello {}, it's {}!", name, Local::now().to_rfc2822()); } fn main() -> Result<(), Box<dyn std::error::Error>> { let mut schedule = Scheduler::new(); every(2) .to(8)? .seconds()? .until(Local::now() + chrono::Duration::seconds(30))? .run_one_arg(&mut schedule, greet, "Good-Looking")?; println!("Starting at {}", Local::now()); loop { if let Err(e) = schedule.run_pending() { eprintln!("Error: {}", e); } sleep(Duration::from_secs(1)); } }
Check out the example script to see more configuration options. Try cargo run --example readme or cargo run --example basic to see it in action.
CFFI
There is an experimental C foreign function interface, which is feature-gated and not included by default. To build the library with this feature, use cargo build --features ffi. See the Makefile and examples/ffi/c directory for details on using this library from C. Execute make run to build and execute the included example C program. It currently only supports work functions which take no arguments.
Development
Clone this repo. See CONTRIBUTING.md for contribution guidelines.
Dependencies
- Stable Rust: The default stable toolchain is fine. Obtainable via
rustupusing the instructions at this link.
Crates
- chrono - Date and time handling
- log - Logging
- pretty_env_logger - Pretty logging
- lazy_static - Lazily evaluated statics
- rand - Random number generation
- regex - Regular expressions
- thiserror - Error derive macro
Development-Only
- pretty_assertions - Colorful assertion output
20 Dec 29, 2022
102 Dec 30, 2022
62 Dec 5, 2022
156 Aug 8, 2023
24 Sep 22, 2022
15 Dec 16, 2022
6 Dec 23, 2022
117 Apr 26, 2023
5 Aug 5, 2023
4 Dec 25, 2023
3 Dec 19, 2022
2 Dec 21, 2021
26 Feb 7, 2022
7 Feb 7, 2023
6 Dec 30, 2022
139 Dec 30, 2022
13 Dec 6, 2022
2 Mar 12, 2022
24 Dec 26, 2022
100 Dec 26, 2022
421 Dec 28, 2022
38 Nov 25, 2022
294 Dec 23, 2022
18.7k Dec 30, 2022
529 Jan 9, 2023
3 May 1, 2023
5 Jun 1, 2023
2 Dec 1, 2022