zng/tests/README.md

Tests

This directory contains integration and macro tests or any test that is not a unit test.

Running

Use cargo do test -t command to run tests in the ./command.rs file.

Use cargo do test -m * to run all macro tests.

Use cargo do test -m property/* to run build test cases that match the path relative to ./macro-tests/cases.

Adding an Integration Test

To add an integration test, create a file then add it in ./Cargo.toml as a [[bin]].

In ./foo.rs:

use zng::prelude::*;

#[test]
fn foo() {
    assert!(true);
}

Then add in ./Cargo.toml:

[[test]]
name = "foo"
path = "foo.rs"

Then run from the project root using cargo do test -t foo.

Adding a Macro Test

Macro tests verify the write output of compile time error messages. To add a test simply add a file in ./macro-tests/cases/<category>/<test>.rs and then call do test -m <category>/<test>. The first run will generate a <test>.stderr file that you can review.