#[fixture]
Expand description
Create tests from files.
NOTE: Path should be relative to the directory of Cargo.toml
file.
This is limitation of current proc macro api.
§Why
If you create test dynamically, running a specific test become very cumbersome.
For example, if you use test
crate with nightly, you can’t use cargo test foo
to run tests with name containing foo
. Instead, you have to implement
your own ignoring logic
§Usage
If you want to load all typescript files from pass
#[fixture("pass/**/*.{ts,tsx}")]
fn pass(file: PathBuf) {
// test by reading file
}
§Return value
The function is allowed to return Result
on error. If it’s the case
§Ignoring a test
If the path to the file contains a component starts with .
(dot), it will
be ignore. This convention is widely used in many projects (including other
languages), as a file or a directory starting with .
means hidden file in
unix system.
Note that they are added as a test #[ignore]
, so you can use
cargo test -- --ignored
or cargo test -- --include-ignored
to run those
tests.
§Roadmap
- Support async function