insta-fun 1.1.2

Snapshot testing of fundsp units. Visualize output in svg and compare using insta
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

# insta-fun

SVG snapshot testing for FunDSP audio units.

Generate visual snapshots of audio processing units to catch regressions and verify signal behavior.

![Example](https://raw.githubusercontent.com/anvlkv/insta-fun/refs/heads/main/src/snapshots/insta_fun__tests__macro_with_input.snap.svg)

> **Note:** Snapshot assertion uses `insta::assert_binary_snapshot` which is currently experimental.

## Usage

```rust
use insta_fun::prelude::*;
use fundsp::prelude::*;

#[test]
fn example_test() {
    // Simple snapshot
    let unit = sine_hz::<f32>(440.0);
    let svg = snapshot_audio_unit(unit);

    // With input signal
    let filter = lowpass_hz(1000.0, 1.0);
    let svg = snapshot_audio_unit_with_input(filter, InputSource::impulse());

    // Custom configuration
    let config = SnapshotConfigBuilder::default().num_samples(100).build().unwrap();
    let svg = snapshot_audio_unit_with_options(sine_hz::<f32>(440.0), config);

    // With a macro
    let unit = sine_hz::<f32>(440.0);
    assert_audio_unit_snapshot!(unit);
}
```

## Features

- Visualizes audio unit inputs and outputs as SVG waveforms
- Supports multi-channel audio with color-coded traces
- Configurable sample count, SVG dimensions, and processing modes
- Built-in input generators (impulse, sine, custom)
- Batch or tick-by-tick processing
- Warmup
- Chart layouts with legend
- Label formatting
- Assertion macro

## Processing Modes

- **Tick**: Process one sample at a time (default) for testing `fundsp::AudioUnit::tick`
- **Batch**: Process up to 64 samples at once for testing `fundsp::AudioUnit::process`

## Examples

See [snapshots](https://github.com/anvlkv/insta-fun/tree/main/src/snapshots) for full list of example charts.

See [tests](https://github.com/anvlkv/insta-fun/tree/main/src/tests.rs) for all usage examples.

## The Unlicense

See [LICENSE](https://raw.githubusercontent.com/anvlkv/insta-fun/refs/heads/main/LICENSE) file for details.