Crate test4a

Testing library that provides some tools to apply "Advanced" Arrange-Act-Assert testing design.

Examples

use test4a::{Equal, Message, PanicWhen, Runner};

// Definition of the structure that contains expected values.
struct Expected {
    value: usize,
}

// Definition of the "act" methods.
fn add_0(message: &mut Message, value: &mut usize) {
    message.set("Add 0 to the initial integer");
    *value += 0;
}

fn add_1(message: &mut Message, value: &mut usize) {
    message.set("Add 1 to the initial integer");
    *value += 1;
}

fn subtract_1(message: &mut Message, value: &mut usize) {
    message.set("Subtract 1 to the initial integer");
    *value -= 1;
}

// Definition of the "assert" methods.
fn expect_value(
    message: &mut Message,
    value: usize,
    expected: Expected,
) -> Equal<usize> {
    message.set("value == expected.value");
    Equal::new(value, expected.value)
}

// Definition of the tests to execute.
#[test]
fn test_zero() {
    Runner::arrange(|message| {
        message.set("Initial value of 0");
        0
    })
    .act(add_0, || Expected { value: 0 })
    .act(add_1, || Expected { value: 1 })
    .act_panic(PanicWhen::Debug, subtract_1)
    .assert(expect_value);
}

#[test]
fn test_other() {
    Runner::arrange(|message| {
        message.set("Initial value of 42");
        42
    })
    .act(add_0, || Expected { value: 42 })
    .act(add_1, || Expected { value: 43 })
    .act(subtract_1, || Expected { value: 41 })
    .assert(expect_value);
}

Structs

Contains	Asserts that a value is in a vector.
Equal	Asserts that two values are equal.
False	Asserts that a value is false.
Greater	Asserts that a value is greater than another one.
GreaterEqual	Asserts that a value is greater than or equal to another one.
Less	Asserts that a value is less than another one.
LessEqual	Asserts that a value is less than or equal to another one.
Message	Stores messages for successive steps of a test.
Multiple	Asserts that multiple assertions created from an iterator have succeed.
NotEqual	Asserts that two values are different.
Runner	Describes and runs multiple tests.
True	Asserts that a value is true.

Enums

PanicWhen

Defines the configurations when a test can panic.

Traits

Assert

Defines an assertion.