easy_schedule/

lib.rs

use async_trait::async_trait;
use std::fmt::{self, Debug};
use time::{Date, OffsetDateTime, Time};
use tokio::{
    select,
    time::{Duration, Instant, sleep, sleep_until},
};
pub use tokio_util::sync::CancellationToken;
use tracing::{error, instrument};

#[derive(Debug, Clone)]
pub enum Skip {
    /// skip fixed date
    Date(Date),
    /// skip date range
    DateRange(Date, Date),
    /// skip days
    ///
    /// 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday, 7: Sunday
    Day(Vec<u8>),
    /// skip days range
    ///
    /// 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday, 7: Sunday
    DayRange(usize, usize),
    /// skip fixed time
    Time(Time),
    /// skip time range
    ///
    /// end must be greater than start
    TimeRange(Time, Time),
    /// no skip
    None,
}

impl Default for Skip {
    fn default() -> Self {
        Self::None
    }
}

impl fmt::Display for Skip {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Skip::Date(date) => write!(f, "date: {}", date),
            Skip::DateRange(start, end) => write!(f, "date range: {} - {}", start, end),
            Skip::Day(day) => write!(f, "day: {:?}", day),
            Skip::DayRange(start, end) => write!(f, "day range: {} - {}", start, end),
            Skip::Time(time) => write!(f, "time: {}", time),
            Skip::TimeRange(start, end) => write!(f, "time range: {} - {}", start, end),
            Skip::None => write!(f, "none"),
        }
    }
}

impl Skip {
    /// check if the time is skipped
    pub fn is_skip(&self, time: OffsetDateTime) -> bool {
        match self {
            Skip::Date(date) => time.date() == *date,
            Skip::DateRange(start, end) => time.date() >= *start && time.date() <= *end,
            Skip::Day(day) => day.contains(&(time.day() + 1)),
            Skip::DayRange(start, end) => {
                time.day() + 1 >= *start as u8 && time.day() + 1 <= *end as u8
            }
            Skip::Time(time) => time.hour() == time.hour() && time.minute() == time.minute(),
            Skip::TimeRange(start, end) => {
                assert!(start < end, "start must be less than end");
                time.hour() >= start.hour()
                    && time.hour() <= end.hour()
                    && time.minute() >= start.minute()
                    && time.minute() <= end.minute()
            }
            Skip::None => false,
        }
    }
}

#[derive(Debug, Clone)]
pub enum Task {
    /// wait seconds
    Wait(u64, Option<Vec<Skip>>),
    /// interval seconds
    Interval(u64, Option<Vec<Skip>>),
    /// at time
    At(Time, Option<Vec<Skip>>),
    /// exact time
    Once(OffsetDateTime),
}

impl fmt::Display for Task {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Task::Wait(wait, skip) => {
                let skip = skip
                    .clone()
                    .unwrap_or_default()
                    .into_iter()
                    .map(|s| s.to_string())
                    .collect::<Vec<String>>()
                    .join(", ");
                write!(f, "wait: {} {}", wait, skip)
            }
            Task::Interval(interval, skip) => {
                let skip = skip
                    .clone()
                    .unwrap_or_default()
                    .into_iter()
                    .map(|s| s.to_string())
                    .collect::<Vec<String>>()
                    .join(", ");
                write!(f, "interval: {} {}", interval, skip)
            }
            Task::At(time, skip) => {
                let skip = skip
                    .clone()
                    .unwrap_or_default()
                    .into_iter()
                    .map(|s| s.to_string())
                    .collect::<Vec<String>>()
                    .join(", ");
                write!(f, "at: {} {}", time, skip)
            }
            Task::Once(time) => write!(f, "once: {}", time),
        }
    }
}

/// a task that can be scheduled
#[async_trait]
pub trait ScheduledTask: Sync + Send {
    /// get the schedule type
    fn get_schedule(&self) -> Task;

    /// called when the task is scheduled
    async fn on_time(&self, cancel: CancellationToken);

    /// called when the task is skipped
    async fn on_skip(&self, cancel: CancellationToken);
}

pub struct Scheduler {
    cancel: CancellationToken,
}

impl Scheduler {
    /// start the scheduler
    pub async fn start<T: ScheduledTask + 'static>(task: T) -> CancellationToken {
        let schedule = task.get_schedule();
        let cancel = CancellationToken::new();
        match schedule {
            Task::Wait(..) => {
                Scheduler::run_wait(task, cancel.clone()).await;
            }
            Task::Interval(..) => {
                Scheduler::run_interval(task, cancel.clone()).await;
            }
            Task::At(..) => {
                Scheduler::run_at(task, cancel.clone()).await;
            }
            Task::Once(..) => {
                Scheduler::run_once(task, cancel.clone()).await;
            }
        }

        cancel
    }

    /// stop the scheduler
    ///
    /// this will cancel all the tasks
    pub fn stop(&self) {
        self.cancel.cancel();
    }
}

fn get_next_time(now: OffsetDateTime, time: Time) -> OffsetDateTime {
    let mut next = now.replace_time(time);
    if next < now {
        next = next + time::Duration::days(1);
    }
    next
}

fn get_now() -> Option<OffsetDateTime> {
    match OffsetDateTime::now_local() {
        Ok(now) => Some(now),
        Err(e) => {
            error!("failed to get local time: {}", e);
            None
        }
    }
}

impl Scheduler {
    /// run wait task
    #[instrument(skip(task, cancel))]
    async fn run_wait<T: ScheduledTask + 'static>(task: T, cancel: CancellationToken) {
        if let Task::Wait(wait, skip) = task.get_schedule() {
            let task_ref = task;
            tokio::task::spawn(async move {
                select! {
                    _ = cancel.cancelled() => {
                        return;
                    }
                    _ = sleep(Duration::from_secs(wait)) => {
                        tracing::debug!(wait, "wait seconds");
                    }
                };
                if let Some(now) = get_now() {
                    if let Some(skip) = skip {
                        if skip.iter().any(|s| s.is_skip(now)) {
                            task_ref.on_skip(cancel.clone()).await;
                            return;
                        }
                    }
                    task_ref.on_time(cancel.clone()).await;
                }
            });
        }
    }

    /// run interval task
    #[instrument(skip(task, cancel))]
    async fn run_interval<T: ScheduledTask + 'static>(task: T, cancel: CancellationToken) {
        if let Task::Interval(interval, skip) = task.get_schedule() {
            let task_ref = task;
            tokio::task::spawn(async move {
                loop {
                    select! {
                        _ = cancel.cancelled() => {
                            return;
                        }
                        _ = sleep(Duration::from_secs(interval)) => {
                            tracing::debug!(interval, "interval");
                        }
                    };
                    if let Some(now) = get_now() {
                        if let Some(ref skip) = skip {
                            if skip.iter().any(|s| s.is_skip(now)) {
                                task_ref.on_skip(cancel.clone()).await;
                                continue;
                            }
                        }
                        task_ref.on_time(cancel.clone()).await;
                    }
                }
            });
        }
    }

    /// run at task
    #[instrument(skip(task, cancel))]
    async fn run_at<T: ScheduledTask + 'static>(task: T, cancel: CancellationToken) {
        if let Task::At(time, skip) = task.get_schedule() {
            let task_ref = task;
            tokio::task::spawn(async move {
                let now = if let Some(now) = get_now() {
                    now
                } else {
                    return;
                };
                let mut next = get_next_time(now, time);
                loop {
                    let now = if let Some(now) = get_now() {
                        now
                    } else {
                        return;
                    };
                    let seconds = (next - now).as_seconds_f64() as u64;
                    let instant = Instant::now() + Duration::from_secs(seconds);
                    select! {
                        _ = cancel.cancelled() => {
                            return;
                        }
                        _ = sleep_until(instant) => {
                            tracing::debug!("at time");
                        }
                    }

                    if let Some(skip) = skip.clone() {
                        if skip.iter().any(|s| s.is_skip(now)) {
                            task_ref.on_skip(cancel.clone()).await;
                            return;
                        }
                    }

                    task_ref.on_time(cancel.clone()).await;

                    next += time::Duration::days(1);
                }
            });
        }
    }

    /// run once task
    #[instrument(skip(task, cancel))]
    async fn run_once<T: ScheduledTask + 'static>(task: T, cancel: CancellationToken) {
        if let Task::Once(next) = task.get_schedule() {
            let task_ref = task;
            tokio::task::spawn(async move {
                if let Some(now) = get_now() {
                    if next < now {
                        task_ref.on_skip(cancel.clone()).await;
                        return;
                    }
                    let seconds = (next - now).as_seconds_f64() as u64;
                    let instant = Instant::now() + Duration::from_secs(seconds);

                    select! {
                        _ = cancel.cancelled() => {
                            return;
                        }
                        _ = sleep_until(instant) => {
                            tracing::debug!("once time");
                        }
                    }
                    task_ref.on_time(cancel.clone()).await;
                }
            });
        }
    }
}