truce-rack-test 1.1.2

Assertion helpers for truce-rack host implementations (load, render, state, params)
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

# truce-rack-test

[![crates.io](https://img.shields.io/crates/v/truce-rack-test.svg)](https://crates.io/crates/truce-rack-test)
[![docs.rs](https://img.shields.io/badge/docs.rs-blue)](https://docs.rs/truce-rack-test)

Assertion helpers for [**truce-rack**][repo] host integration
tests — render N frames of silence (or a generated input) through
a [`Plugin<f32>`][core], assert no NaN / no clipping / state
round-trips. Use these from per-format integration suites that
exercise a [`PluginScanner`][core] impl across a corpus.

[repo]: https://github.com/truce-audio/truce-rack
[core]: https://crates.io/crates/truce-rack-core

## Usage

```toml
[dev-dependencies]
truce-rack-core = "1.0"
truce-rack-test = "1.0"
```

```rust
use truce_rack_core::scanner::PluginScanner;
use truce_rack_test::{render_silence, assert_no_nans, assert_state_round_trip};

let scanner = MyScanner::new();
for info in scanner.scan()? {
    let mut plugin = scanner.load(&info)?;
    let rendered = render_silence(&mut plugin, 48_000.0, 1024)?;
    assert_no_nans(&rendered);
    assert_state_round_trip(&mut plugin)?;
}
```

## See also

The [**truce-rack**][repo] workspace ships per-format wrapper
crates this helper exercises — see
[`truce-rack-clap`](https://crates.io/crates/truce-rack-clap),
[`truce-rack-vst3`](https://crates.io/crates/truce-rack-vst3),
[`truce-rack-au`](https://crates.io/crates/truce-rack-au),
[`truce-rack-au3`](https://crates.io/crates/truce-rack-au3),
[`truce-rack-lv2`](https://crates.io/crates/truce-rack-lv2).

## License

MIT or Apache-2.0, at your option.