Struct endbasic_std::testutils::Checker

#[must_use]pub struct Checker<'a> { /* fields omitted */ }

Captures expectations about the execution of a command and validates them.

Implementations

impl<'a> Checker<'a>

pub fn expect_ok(mut self: Self, stop_reason: StopReason) -> Self

Expects the invocation to have successfully terminated with the given stop_reason.

If not called, defaults to expecting that execution terminated due to EOF. This or expect_err can only be called once.

pub fn expect_err<S: Into<String>>(mut self: Self, message: S) -> Self

Expects the invocation to have erroneously terminated with the exact message.

If not called, defaults to expecting that execution terminated due to EOF. This or expect_err can only be called once.

pub fn expect_file<N: Into<String>, C: Into<String>>(
    mut self: Self,
    name: N,
    content: C
) -> Self

Adds a file to expect in the store with a name and specific content.

pub fn expect_output<V: Into<Vec<CapturedOut>>>(mut self: Self, out: V) -> Self

Adds the out sequence of captured outputs to the expected outputs of the execution.

pub fn expect_prints<S: Into<String>, V: Into<Vec<S>>>(
    mut self: Self,
    out: V
) -> Self

Adds the out sequence of strings to the expected outputs of the execution.

This is a convenience function around expect_output that wraps all incoming strings in CapturedOut::Print objects, as these are the most common outputs in tests.

pub fn expect_program<S: Into<String>>(mut self: Self, text: S) -> Self

Sets the expected contents of the stored program to text. Can only be called once and text must not be empty.

pub fn expect_var<S: Into<String>, V: Into<Value>>(
    mut self: Self,
    name: S,
    value: V
) -> Self

Adds the name/value pair as a variable to expect in the final state of the machine.

pub fn check(self)

Validates all expectations.