Struct SimpleScheduler 

pub struct SimpleScheduler { /* private fields */ }

Scheduler for the Soroban-first SimpleWorld runtime.

Systems can be grouped into stages and ordered relative to each other using SystemConfig::before() and SystemConfig::after(). Each system receives a deferred CommandQueue through SystemContext; queued commands are applied after the system finishes.

Example

use cougr_core::scheduler::{ScheduleStage, SimpleScheduler, SystemConfig};
use cougr_core::simple_world::SimpleWorld;
use soroban_sdk::{symbol_short, Bytes, Env};

fn physics_system(world: &mut SimpleWorld, env: &Env) {
    let entity = world.spawn_entity();
    world.add_component(entity, symbol_short!("physics"), Bytes::new(env));
}
fn scoring_system(world: &mut SimpleWorld, env: &Env) {
    let entity = world.spawn_entity();
    world.add_component(entity, symbol_short!("scoring"), Bytes::new(env));
}

let env = Env::default();
let mut world = SimpleWorld::new(&env);
let mut scheduler = SimpleScheduler::new();
scheduler.add_system("physics", physics_system);
scheduler.add_system_with_config(
    "scoring",
    scoring_system,
    SystemConfig::new()
        .in_stage(ScheduleStage::Update)
        .after("physics"),
);
scheduler.run_all(&mut world, &env).unwrap();
assert_eq!(scheduler.system_count(), 2);

Implementations

impl SimpleScheduler

pub fn new() -> Self

pub fn add_system<F>(&mut self, name: &'static str, system: F)

where F: FnMut(&mut SimpleWorld, &Env) + 'static,

Add a world/env system to the Update stage.

pub fn add_system_with_config<F>( &mut self, name: &'static str, system: F, config: SystemConfig, )

where F: FnMut(&mut SimpleWorld, &Env) + 'static,

Add a world/env system with explicit scheduling rules.

pub fn add_system_in_stage<F>( &mut self, stage: ScheduleStage, name: &'static str, system: F, )

where F: FnMut(&mut SimpleWorld, &Env) + 'static,

Add a world/env system directly to a specific stage.

pub fn add_context_system<F>(&mut self, name: &'static str, system: F)

where F: for<'w, 'e, 'c> FnMut(&mut SystemContext<'w, 'e, 'c>) + 'static,

Add a context-aware system to the Update stage.

pub fn add_context_system_with_config<F>( &mut self, name: &'static str, system: F, config: SystemConfig, )

where F: for<'w, 'e, 'c> FnMut(&mut SystemContext<'w, 'e, 'c>) + 'static,

Add a context-aware system with explicit scheduling rules.

pub fn add_context_system_in_stage<F>( &mut self, stage: ScheduleStage, name: &'static str, system: F, )

where F: for<'w, 'e, 'c> FnMut(&mut SystemContext<'w, 'e, 'c>) + 'static,

Add a context-aware system directly to a specific stage.

pub fn add_simple_system<S>(&mut self, name: &'static str, system: S)

where S: AppSystem + 'static,

Add any pre-built runtime system to the default Update stage.

pub fn add_simple_system_with_config<S>( &mut self, name: &'static str, system: S, config: SystemConfig, )

where S: AppSystem + 'static,

Add any pre-built runtime system with explicit scheduling rules.

pub fn add_simple_system_in_stage<S>( &mut self, stage: ScheduleStage, name: &'static str, system: S, )

where S: AppSystem + 'static,

Add any pre-built runtime system directly to a specific stage.

pub fn add_system_spec<S>(&mut self, spec: SystemSpec<S>)

where S: AppSystem + 'static,

Add a declarative runtime system spec.

pub fn add_systems<G>(&mut self, group: G)

where G: SystemGroup,

Add one or more runtime systems using the modern declarative API.

pub fn add_systems_in_stage<G>(&mut self, stage: ScheduleStage, group: G)

where G: SystemGroup,

Add one or more runtime systems while forcing them into a stage.

pub fn configure_system( &mut self, name: &str, config: SystemConfig, ) -> Result<(), ScheduleError>

Update the scheduling config for an already-registered system.

pub fn run_all( &mut self, world: &mut SimpleWorld, env: &Env, ) -> Result<(), ScheduleError>

Validate and execute the full schedule.

pub fn run_stage( &mut self, stage: ScheduleStage, world: &mut SimpleWorld, env: &Env, ) -> Result<(), ScheduleError>

Validate and execute only a single stage.

pub fn system_count(&self) -> usize

Returns the number of registered systems.

pub fn system_names(&self) -> Vec<&str>

Returns the system names in registration order.

pub fn stage_system_names( &self, stage: ScheduleStage, ) -> Result<Vec<&str>, ScheduleError>

Returns the system names assigned to a given stage in execution order.

Trait Implementations

impl Default for SimpleScheduler

fn default() -> Self

Returns the “default value” for a type.