Module testutils

Source
Expand description

Test utilities for consumers of the EndBASIC interpreter.

Structs§

Checker
Captures expectations about the execution of a command and validates them.
MockConsole
A console that supplies golden input and captures all output.
RecordedProgram
A stored program that exposes golden contents and accepts new content from the console when edits are requested.
Tester
Builder pattern to prepare an EndBASIC machine for testing purposes.

Enums§

CapturedOut
A captured command or messages sent to the mock console.

Functions§

check_expr_compilation_error
Executes expr on a scripting interpreter and ensures that evaluation fails with exp_error during compilation.
check_expr_error
Executes expr on a scripting interpreter and ensures that evaluation fails with exp_error.
check_expr_ok
Executes expr on a scripting interpreter and ensures that the result is exp_value.
check_expr_ok_with_vars
Executes expr on a scripting interpreter and ensures that the result is exp_value.
check_stmt_compilation_err
Executes stmt on a default Tester instance and checks that it fails with exp_error during compilation.
check_stmt_err
Executes stmt on a default Tester instance and checks that it fails with exp_error.
flatten_output
Flattens the captured output into a single string resembling what would be shown in the console for ease of testing.