etest 0.3.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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

[![crates.io][crates-badge]][crates-url]
[![docs.rs][docs-badge]][docs-url]
[![Coverage Status][coveralls-badge]][coveralls-url]
[![Build Status][ci-badge]][ci-url]

[crates-badge]:    https://img.shields.io/crates/v/etest.svg
[crates-url]:      https://crates.io/crates/etest
[docs-badge]:      https://img.shields.io/docsrs/etest/latest
[docs-url]:        https://docs.rs/etest/latest/etest/index.html
[coveralls-badge]: https://coveralls.io/repos/github/ensc/etest/badge.svg?branch=master
[coveralls-url]:   https://coveralls.io/github/ensc/etest?branch=master
[ci-badge]:        https://github.com/ensc/etest/actions/workflows/rust.yml/badge.svg
[ci-url]:          https://github.com/ensc/etest/actions/workflows/rust.yml

# 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 of the toplevel `etest` crate (content of `src` folder) is
licensed under LGPL-3.0-or-later with an exception which removes
restrictions regarding static linking.

Implementation details (crates in the `etest-derive` + `etest-impl`
folders) 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.