Struct Tester

pub struct Tester { /* private fields */ }

Builder pattern to prepare an EndBASIC machine for testing purposes.

Implementations

impl Tester

pub fn empty() -> Self

Creates a new tester with an empty Machine.

pub fn add_callable(self, callable: Rc<dyn Callable>) -> Self

Registers the given builtin command into the machine, which must not yet be registered.

pub fn add_input_chars(self, golden_in: &str) -> Self

Adds the golden_in characters as console input.

pub fn add_input_keys(self, keys: &[Key]) -> Self

Adds a bunch of keys as golden input to the console.

pub fn get_machine(&mut self) -> &mut Machine

Returns a mutable reference to the machine inside the tester.

This method should generally not be used, except to run native methods that have side-effects on the machine that we’d like to validate later.

pub fn get_console(&self) -> Rc<RefCell<MockConsole>>

Gets the mock console from the tester.

This method should generally not be used. Its primary utility is to hook externally-instantiated commands into the testing features.

pub fn get_program(&self) -> Rc<RefCell<RecordedProgram>>

Gets the recorded program from the tester.

This method should generally not be used. Its primary utility is to hook externally-instantiated commands into the testing features.

pub fn get_storage(&self) -> Rc<RefCell<Storage>>

Gets the storage subsystem from the tester.

This method should generally not be used. Its primary utility is to hook externally-instantiated commands into the testing features.

pub fn set_var(self, name: &str, value: Value) -> Self

Sets a variable to an initial value.

pub fn set_program(self, name: Option<&str>, text: &str) -> Self

Sets the initial name of the recorded program to name (if any) and its contents to text. Can only be called once and text must not be empty.

pub fn write_file(self, name: &str, content: &str) -> Self

Creates or overwrites a file in the storage medium.

pub fn run<S: Into<String>>(&mut self, script: S) -> Checker<'_>

Runs script in the configured machine and returns a Checker object to validate expectations about the execution.

pub fn run_n(&mut self, scripts: &[&str]) -> Checker<'_>

Runs scripts in the configured machine and returns a Checker object to validate expectations about the execution.

The first entry in scripts to fail aborts execution and allows checking the result of that specific invocation.

This is useful when compared to run because Machine::exec compiles the script as one unit and thus compilation errors may prevent validating other operations later on.

Trait Implementations

impl Default for Tester

fn default() -> Self

Creates a new tester for a fully-equipped (interactive) machine.