etest 0.1.0

Allows to control behaviour of `#[test]` like functions
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

# About

`etest` allows to control behaviour of `#[test]` like functions:

- it allows to specify the maximum runtime of a test (`timeout` parameter)

- it allows to skip a test based on the result of another function
  (`skip_*` parameter class)

- it allows to limit parallel execution of tests by making it dependend
  on resources which are simply used ("shared" usage) or consumed for
  the duration of test ("exclusive" usage)

# Example

```rust
#[etest(skip=is_today_monday(),
        timeout=2_000,
        consumes=["video", "audio"],
        uses=["network"])]
fn test_00() {
    do_something();
}
```

This test will:

- be skipped at monday

- will be aborted after 2 seconds

- will use "video" and "audio" resources exclusively; e.g. there will
  be no other test running which uses one or both of these resources

- will share the "network" resource; e.g. other tests which share this
  resource are allowed at the same time, but no tests which use it
  exclusively.

# License

The code which is linked to tests, is licensed under LGPL-3.0-or-later.
This includes the content of the toplevel `etest` crate.

Implementation details (`etest-derive` + `etest-impl`) are licensed under
GPL-3.0-or-later with the explicit permission to use and distribute the
generated code (the expanded macro) under terms of your choice.

Independent tests (`etest-tests`) are licensed under GPL-3.0-or-later.