#cron #cron-expression #bevy-plugin #bevy #plugin #bevy-ecs

bevy_cronjob

A simple helper to run cronjobs (at repeated schedule) in Bevy

7 releases (4 breaking)

0.5.0-rc.1 Oct 23, 2024
0.4.0 Jul 5, 2024
0.3.0 Feb 18, 2024
0.2.0 Nov 6, 2023
0.1.2 Aug 7, 2023

#1467 in Game dev

Download history 13/week @ 2024-07-29 11/week @ 2024-09-23 3/week @ 2024-09-30 114/week @ 2024-10-21 16/week @ 2024-11-04

130 downloads per month

MIT/Apache

21KB

crates.io MIT/Apache 2.0 crates.io CI Documentation

bevy_cronjob

bevy_cronjob is a simple helper to run cronjobs (at repeated schedule) in Bevy.

Usage

use std::time::Duration;
use bevy::{ MinimalPlugins};
use bevy::app::{App, PluginGroup, ScheduleRunnerPlugin, Update};
use bevy::log::{info, LogPlugin};

use bevy_ecs::prelude::{IntoSystemConfigs};
use bevy_cronjob::schedule_passed;

fn main() {
    App::new()
        .add_plugins(
            MinimalPlugins.set(ScheduleRunnerPlugin::run_loop(Duration::from_secs_f64(
                1.0 / 60.0,
            ))),
        )
        .add_plugins(LogPlugin::default())
        .add_systems(Update, print_per_5_sec.run_if(schedule_passed("0/5 * * * * *")))
        .add_systems(Update, print_per_min.run_if(schedule_passed("0 * * * * *")))
        .add_systems(Update, print_per_hour.run_if(schedule_passed("0 0 * * * *")))
        .run();
}

fn print_per_5_sec() {
    info!("print every 5 sec")
}

fn print_per_min() {
    info!("print every minute")
}
fn print_per_hour() {
    info!("print every hour")
}

Expression

the scheduling expression is base on cron

sec min hour day of month month day of week year
* * * * * * *
0-59 0-59 0-23 1-23 1-12 1-7 1970-2100

Time is specified in UTC. Note that the year may be omitted.

Comma separated values such as 1,2,3 are allowed. For example, a schedule of 0,15,30,45 * * * * *' would execute on every 15 seconds.

Ranges can be specified with a dash. For example 1-5 * * * * *' would execute on every second for the first 5 seconds of a minute.

Supported Versions

bevy bevy_cronjob
0.15 0.5
0.14 0.4
0.13 0.3
0.12 0.2
0.11 0.1

License

Dual-licensed under either

  • MIT
  • Apache 2.0

Dependencies

~11–21MB
~294K SLoC