potassium 0.2.2

A lean and mean job scheduler
Documentation

🍌 Potassium - A lean mean job 'n task machine

Potassium is a job scheduler for modern multi-threaded game engines.

It is designed so that the entire engine can be built around it in order to maximize CPU utilization.

Features

  • ✅ Job dependencies
  • ✅ Priority scheduling
  • 🕑 Configurable worker threads - coming soon
  • 🕑 Job graphs (DAGs) - coming soon
  • 🕑 Fiber support (resumable jobs) - coming soon

Example Usage

let scheduler = Scheduler::new();
println!("Running with {} workers", scheduler.num_workers());

let _long_job = scheduler
    .job_builder("long_job")
    .priority(Priority::Low)
    .spawn(|| {
        std::thread::sleep(std::time::Duration::from_secs(2));
        println!("Long job completed.");
    });

let job1 = scheduler
    .job_builder("job1")
    .priority(Priority::High)
    .spawn(|| {
        // Doing some hard work
        std::thread::sleep(std::time::Duration::from_millis(200));
    });

let job2 = scheduler
    .job_builder("job2")
    .priority(Priority::Medium)
    .spawn(|| {
        // Doing some medium work
        std::thread::sleep(std::time::Duration::from_millis(300));
    });

let job_sync = scheduler
    .job_builder("sync_job")
    .priority(Priority::Medium)
    .dependencies(vec![job1, job2])
    .spawn(|| {
        println!("All small jobs completed. Running sync job.");
    });

// Jobs can be awaited using the returned JobHandle
job_sync.wait();
println!("Small job sync completed. Big job should finish shortly.");
scheduler.wait_for_all();
println!("All jobs completed.");