dyntest 0.2.0

Dynamically create test cases.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

# `dyntest`

A small Rust library for dynamically creating test cases.

## Usage

```toml
# Cargo.toml
[[test]]
name = "test_name"
harness = false
```
```rust
// tests/test_name.rs

use dyntest::{dyntest, DynTester};

dyntest!(test);

fn test(t: &mut DynTester) {
  for (str, len) in [("a", 1), ("pq", 2), ("xyz", 3)] {
    t.test(str, move || {
      assert_eq!(str.len(), len);
    });
  }
}
```
```text
running 3 tests
test a ... ok
test pq ... ok
test xyz ... ok

test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
```

## Features

### Test Grouping

Using `DynTester::group`, multiple related tests can be given a shared prefix, akin to a `mod` for static tests:
```rust
use dyntest::{dyntest, DynTester};

dyntest!(test);

fn test(t: &mut DynTester) {
  panic!("hi");
  t.group("foo", |t| {
    t.group("bar", |t| {
      t.test("baz", || {});
    });
    t.test("qux", || {});
  });
}
```
```text
running 2 tests
test foo::bar::baz ... ok
test foo::qux ... ok

test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
```

### Globbing

When the `glob` feature is enabled (which it is by default), `DynTester` exposes
`glob` and `glob_in` methods, which facilitate generating tests from files in a
directory:
```rust
use dyntest::{dyntest, DynTester};

dyntest!(test);

fn test(t: &mut DynTester) {
  for (name, path) in t.glob_in("my/test/files/", "**/*.ext") {
    t.test(name, move || {
      // ...
    });
  }
}
```
```text
my/test/files/
  foo.ext
  bar.ext
  baz/
    qux.ext
    something.unrelated
```
```text
running 3 tests
test foo ... ok
test bar ... ok
test baz::qux ... ok

test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
```

## Limitations

Using `dyntest` requires a nightly compiler, as it uses the unstable `test` crate.

In any given test files, the tests must either be all static or all dynamic; if
you use `dyntest!` in a file, any `#[test]` fns will be silently ignored by
rustc (this is inherent to `harness = false`).

Multiple invocations of `dyntest!` in the same test file are not supported;
either separate it into multiple test files, or merge the `dyntest!` invocations
(the macro supports multiple arguments).