7 releases

0.3.2 Jun 18, 2024
0.3.1 Jul 3, 2023
0.3.0 May 22, 2021
0.2.1 May 10, 2021
0.1.1 May 10, 2021

#112 in Asynchronous

Download history 1847/week @ 2024-08-11 2603/week @ 2024-08-18 2738/week @ 2024-08-25 3094/week @ 2024-09-01 2485/week @ 2024-09-08 2730/week @ 2024-09-15 3376/week @ 2024-09-22 1784/week @ 2024-09-29 1897/week @ 2024-10-06 1031/week @ 2024-10-13 2202/week @ 2024-10-20 1757/week @ 2024-10-27 2823/week @ 2024-11-03 2114/week @ 2024-11-10 2124/week @ 2024-11-17 1915/week @ 2024-11-24

9,040 downloads per month
Used in 23 crates (7 directly)

MIT license

47KB
1.5K SLoC

MIT licensed Version Code Coverage Downloads

This crate provides a library for scheduling periodic tasks. It is inspired by python's schedule lib and provides similar API. It is built on tokio (version 1) and chrono lib

Documentation link

Crates.io link

Example

use std::error::Error;
use chrono::{Utc, Duration, Weekday};
use tokio::spawn;
use tokio_schedule::{every, Job};

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let weekly = every(1).week().on(Weekday::Mon).at(12, 00, 00)
        .in_timezone(&Utc).perform(|| async { println!("Every week job") });
    spawn(weekly);

    let even_weekly = every(2).weeks().on(Weekday::Mon).at(12, 00, 00)
        .in_timezone(&Utc).perform(|| async { println!("Every even week job") });
    spawn(even_weekly);

    let every_30_seconds = every(30).seconds() // by default chrono::Local timezone
        .perform(|| async { println!("Every minute at 00'th and 30'th second") });
    spawn(every_30_seconds);

    let every_30_minutes = every(30).minutes().at(20).in_timezone(&Utc)
        .perform(|| async { println!("Every 30 minutes at 20'th second") });
    spawn(every_30_minutes);

    let every_hour = every(1).hour().at(10, 30).in_timezone(&Utc)
        .perform(|| async { println!("Every hour at :10:30") });
    spawn(every_hour);

    let every_second_1_day = every(1).second().until(&(Utc::now() + Duration::days(1)))
        .in_timezone(&Utc).perform(|| async { println!("Every second until next day") });
    spawn(every_second_1_day);

    let every_day = every(1).day().at(10, 00, 00)
        .in_timezone(&Utc).perform(|| async { println!("I'm scheduled!") });
    every_day.await;

    Ok(())
}

Timezone

By default all jobs use Local timezone. You can use any timezone that implements chrono::Timezone.

Dependencies

~3–8.5MB
~65K SLoC