cronitor

Cron framework in Rust but simple

lib.rs:

Cronitor

Cronitor is a simple and efficient cron framework in Rust. It allows you to schedule and run cron jobs with ease.

!! ATTENTION !! YOU WILL NEED DEPENDENCIES as proc-macros can be funny sometimes.

cronitor = { git = "https://github.com/floris-xlx/cronitor.git", branch = "main" }
cronitor_runtime = { git = "https://github.com/floris-xlx/cronitor.git", branch = "main" }
ctor = "0.2.8"

Examples

Here are some examples of how to use Cronitor:

Example 1: Run a job every minute

use cronitor_macro::cronitor;
use cronitor_runtime::cron_runtime;

#[cronitor("*/1 * * * *")]
fn ping_every_minute() {
    println!("Ping! Pong!");
}

fn main() {
    cron_runtime();
    
    loop {
        std::thread::park();
    }
}

Example 2: Run multiple jobs

use cronitor_macro::cronitor;
use cronitor_runtime::cron_runtime;

#[cronitor("*/5 * * * *")]
fn ping_every_5_minutes() {
    println!("Ping! Pong!");
}

#[cronitor("*/15 * * * *")]
fn ping_every_15_minutes() {
    println!("Ping! Pong! part 2");
}

fn main() {
    cron_runtime();
    
    loop {
        std::thread::park();
    }
}

Example 3: Run a job every day at 6 AM

use cronitor_macro::cronitor;
use cronitor_runtime::cron_runtime;

#[cronitor("0 6 * * *")]
fn ping_every_day_at_6() {
    println!("Ping! Pong!");
}

fn main() {
    cron_runtime();
    
    loop {
        std::thread::park();
    }
}

Example files

Example files can be found in /examples folder. You can run these examples using the following command:

Examples folder

cargo run --example EXAMPLE_FILE.rs

Timezone

Cronitor picks the timezone that the computer is in, ensuring that your cron jobs run according to the local time settings.

Synchronous Contexts

Cronitor is designed for synchronous contexts for now. This means that it is best suited for applications where tasks need to be executed in a sequential manner.

Verify Cron Expressions

If you want to verify a cron expression, you can use this website: https://crontab.cronhub.io/