Struct endbasic_std::testutils::Tester

#[must_use]pub struct Tester { /* fields omitted */ }

Builder pattern to prepare an EndBASIC machine for testing purposes.

Implementations

impl Tester

pub fn from(machine: Machine) -> Self

Creates a new tester using the given 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 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_store(&self) -> Rc<RefCell<InMemoryStore>>

Gets the in-memory store 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 set_program(self, text: &str) -> Self

Sets the initial contents of the recorded program 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 store.

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.