Struct Runner 

pub struct Runner {
    pub registry: Rc<OperationRegistry>,
    pub workspace: Option<Rc<dyn Workspace>>,
    pub location: Location,
    /* private fields */
}

Runs programs on parts, with the operations of registry, reading what they place and import from workspace as the program in the file of location names it: location.within is the stack of files being built, which a file must not place again.

Fields

registry: Rc<OperationRegistry>

workspace: Option<Rc<dyn Workspace>>

location: Location

Implementations

impl Runner

pub fn new(registry: OperationRegistry) -> Self

A runner of the operations of registry, of programs that read and place nothing.

pub fn of( registry: Rc<OperationRegistry>, workspace: Option<Rc<dyn Workspace>>, location: Location, ) -> Self

A runner of the operations of registry, of the program in the file of location of workspace, with a build cache of its own.

pub fn run( &self, part: &mut Part, program: &Program, upto: Option<&str>, ) -> RunOutput

Runs the steps of program before the step upto — all of them, if None — on part, with the program’s state and no inputs. The nodes of the steps after upto are kept for when they run again; those of steps no longer in the program are dropped.

pub fn run_with( &self, part: &mut Part, program: &Program, inputs: &Settings, upto: Option<&str>, ) -> RunOutput

Runner::run, its parameters set to inputs.

pub fn run_step( &self, part: &mut Part, step: &str, body: impl FnOnce(&mut StepContext<'_>) -> GeopResult<()>, ) -> GeopResult<()>

Runs one step by hand, as the step step after those part ran, body declaring what it produces: what a test of one operation does. Fails as body does.

pub fn counts(&self) -> Counts

How much work it and the runners of the parts it placed did.

pub fn cached_builds(&self) -> usize

How many placed parts its build cache holds.

pub fn nested(&self, location: Location) -> Runner

The runner of the part placed from the file of location: what an editor edits a step of it with.

pub fn revision(&self, path: &str) -> u64

The revision of the file at path of its workspace: 0 without one.

pub fn files(&self) -> Vec<String>

The files the program it runs could read, as it names them: every file but its own. None without a workspace.

pub fn read(&self, name: &str) -> GeopResult<(String, Rc<str>)>

The text of the file the program it runs names name, and its path: a file of bytes read as UTF-8, what is not replaced (see crate::workspace::text). A make reads it through its reader, which records the read (crate::reader::Reader::read_file).

pub fn read_bytes(&self, name: &str) -> GeopResult<(String, Rc<[u8]>)>

The bytes of the file the program it runs names name, and its path (see crate::workspace::bytes): what a reader of a binary format reads (crate::reader::Reader::read_bytes).

pub fn program(&self, name: &str) -> GeopResult<(Rc<Program>, Location)>

The program in the file the program it runs names name, and where it would be placed from here. Refuses a file placing the program it runs, however deep: the files would place themselves.