Struct endbasic_std::testutils::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_command(self, command: Rc<dyn Command>) -> Self

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

pub fn add_function(self, function: Rc<dyn Function>) -> Self

Registers the given builtin function 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_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.

Trait Implementations

impl Default for Tester

fn default() -> Self

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